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.