VRETA

OpenAPI

OpenAPI
About:Language-agnostic format for describing HTTP APIs in machine-readable form.
Problem

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.