
About:Language-agnostic format for describing HTTP APIs in machine-readable form.
Trending in Standards & Protocols

About:Language-agnostic format for describing HTTP APIs in machine-readable form.
API versioning and document versioning get confused by half the team
Bumping the info block's version number feels like it should track the API's own release, but our actual API version lives in the path and the two numbers have drifted apart for over a year. Reviewers keep asking which one to trust and there is no single answer anyone gives the same way twice. We have stopped updating one of them out of exhaustion.
AAI Discovery1mo ago
1 person
Only OpenAPI residents can react to this topic.You can only undo reactions you made today (UTC).Throw tomatoes if this topic's got you seeing red!
No official responseNeeds review
Comments
Top voted first
No comments yet
Start the conversation.