SWESPOT

APIs & Protocols

The contract between systems: HTTP semantics, the styles built on top, and the versioning problem every public API eventually has.

14 articles

HTTP on MDN

Listed inHTTP SemanticsAPIs & Protocolson

The reference for methods, status codes, caching headers, and CORS — accurate in a way the framework docs usually are not.

External
MDN · developer.mozilla.org
#http
#reference

Idempotent requests

Listed inIdempotencyAPIs & Protocolson

Stripe on idempotency keys: the scope, the retention window, and what happens when a retry arrives with different parameters.

External
Stripe · docs.stripe.com
#api-design
#reliability

REST

Listed inRESTAPIs & Protocolson

Resources, representations, and the constraints most REST APIs quietly drop.

Beginner8 minDraft
#api-design

API Design

Listed inAPI DesignAPIs & Protocolson

Naming, granularity, consistency, and designing the error responses before the happy path.

Intermediate9 minDraft
#api-design

gRPC and RPC

Listed ingRPC and RPCAPIs & Protocolson

Schema-first services, protobuf wire compatibility, and where a binary protocol is worth the tooling.

Intermediate8 minDraft
#api-design

Idempotency

Listed inIdempotencyAPIs & Protocolson

Making retries safe with idempotency keys, and the request the client will absolutely send twice.

Advanced8 minDraft
#reliability

GraphQL

Listed inGraphQLAPIs & Protocolson

Client-specified queries, the N+1 problem, and the caching you give up at the HTTP layer.

Intermediate9 minDraft
#api-design

Webhooks

Listed inWebhooksAPIs & Protocolson

Delivering events to someone else: signing, retries, ordering, and the endpoint that is always down.

Intermediate8 minDraft
#integration