All articles

Your error messages are an API too

Developers read your 400s more carefully than your docs. Design them like it.

Aug 21, 20268 likes

Pagination you won't regret in two years

Offset pagination feels obvious and betrays you at scale. Here's the cursor pattern, minus the hand-waving.

Aug 13, 20262 likes

API versioning without the tears

Every versioning strategy is a way of choosing who you're going to disappoint. Choose deliberately.

Aug 3, 20267 likes

Webhooks are a distributed systems problem in a trenchcoat

Retries, ordering, idempotency, signatures. The word 'webhook' hides four hard problems.

Jul 23, 20265 likes

An SDK is a promise you have to keep

Publishing a client library changes your relationship with breaking changes forever.

Jul 7, 20263 likes