Versioning
API Contract Versioning: How to Avoid Breaking Integrations
How to record a compatibility promise with SemVer, OpenAPI document versions, and URL or media-type signals, without pretending one of them is required by HTTP.
Tag
OpenAPI
Notes tagged OpenAPI.
-
-
Integration
API Error Models: Designing Errors That Integrators Can Actually Use
How RFC 9457 structures an HTTP error body, which parts a program can rely on, and how to change an error contract without stranding clients.
-
Schemas
What Is an API Schema? A Practical Guide to Request and Response Contracts
What an API schema constrains in a JSON message, how OpenAPI 3.1 relates to JSON Schema, and which decisions the schema file does not make.