REST · OpenAPI · Architecture
Overview
A living personal reference for API design patterns accumulated across nine years of integration work. Not a tutorial — a standard library. The patterns here reflect real decisions made under real constraints, documented to be reusable.
Covers the decisions that matter in production: versioning strategy, idempotency contracts, error response structure, pagination, authentication flows, and the event-driven vs. request-response tradeoff. Built to be cited in architecture documents, not read as a textbook.
Pattern Categories
Content to be expanded. Planned: versioning patterns (URI, header, query), idempotency keys, async operation polling, webhook delivery guarantees, OpenAPI documentation standards, and error taxonomy.
Status
Living document. Updated as new patterns are encountered and validated in production work.