Tag
api-contracts
- Sep 30, 2026 Error Contracts: Problem Details, Stable Codes, and Retry Semantics How to design an error payload that machines can branch on and humans can act on, and why retryability belongs in the contract rather than in the status code alone. software architecture
- Jun 15, 2026 Tolerant Readers, Unknown Fields, and the Cost of Strict Decoding How clients should handle members and enum values they do not recognise, why strict decoding turns every addition into a breaking change, and where tolerance turns into silent corruption. software architecture
- Aug 18, 2025 Breaking Change Detection in API Descriptions Which schema-diff findings are genuinely breaking, which are noise, and why the baseline has to be the released description rather than the previous commit. software architecture
- Jul 9, 2025 Cursor Pagination and the Cost of Deep Offsets Why OFFSET grows linear in page depth, how keyset predicates keep page cost flat, and what an opaque cursor has to carry to stay correct. backend systems
- Apr 22, 2025 Idempotency Keys and the Unknown-Outcome Problem How a client-supplied key turns a retried mutation into at-most-once execution, where the key has to be stored, and which failure windows remain open. backend systems
- Feb 14, 2025 Consumer-Driven Contract Testing and the Cost of Many Consumers How consumer expectations become executable contracts, what verification proves about a provider, and why the pattern needs a broker and a deployment gate to be worth its cost. software architecture
- Nov 25, 2024 Versioning Strategies and What a Version Number Promises How path, header, and media-type versioning differ in what they can express, why a version is a support commitment rather than a name, and when a new version beats a compatible change. software architecture
- Aug 7, 2024 Where an API Contract Ends and the Implementation Begins Which parts of an HTTP exchange callers may depend on, which are incidental, and why undocumented behaviour still turns into a maintenance obligation. software architecture
- Jan 20, 2024 Pagination Contracts and Why Cursors Drift Less Than Offsets How offset and keyset pagination fail under concurrent writes, what a cursor must encode, and which stability guarantees an API can honestly promise. software architecture
- Mar 16, 2023 Idempotency Keys and the Retry Window for Writes How a client-supplied key turns a retried POST into a single effect, what the server has to store to honour it, and where the guarantee quietly expires. software architecture
- Jan 16, 2023 Deprecation Windows and the Gates That Must Close Before Removal How to announce an end date, measure who still depends on an interface, and sequence soft warnings, hard failures, and deletion so that removal is boring. software architecture