Reading List

The most recent articles from a list of feeds I subscribe to.

Why form encoding in web APIs is an anti-pattern

Form encoding does have a few niceties that make it amenable to human use, so what’s wrong with it? Here we explore why to use JSON instead.

API design showcase: OpenAI

How to closely follow Stripe’s API and documentation conventions, but iterate on the bad stuff.

Considerations for event APIs (versus webhooks)

Event APIs are a good idea (and probably a better idea), but do come with a few downsides.

Retry-friendly idempotent delete in web APIs

Making DELETE endpoints in web APIs not just technically idempotent, but friendly for clients that may need to call them multiple times in a retry loop.

`Idempotency-Key` IETF standards draft

Idempotency-Key is a convention long in use by Stripe to provide idempotency on non-idempotent HTTP verbs, and it now has its own IETF standards draft.