A publication about the machinery under everyday software: the contracts between services, the queries behind a page, and the failures that only show up in production.
Request, response and the contract in between — the beat this domain was built on.
APIs & ProtocolsImplementing idempotency keys in a REST API requires more than just deduplicating on key - it demands storing enough detail to reject mismatched retries and safely handle concurrent…
APIs & ProtocolsAs a developer, you've likely hit a code review where two hardworking colleagues spar over which HTTP status code to return for a rejected request. Is it 409 (Conflict) or 422…
APIs & ProtocolsWhen creating an error JSON, most engineers start by copying a format from a previous project. Over time, this casual practice leads to a proliferation of custom error shapes in every…
Designing a client-readable rate-limiting policy for a public API requires sending the right headers at the right time. While the standard HTTP status code is 429 Too Many Requests, RFC…
