
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.
Nullable used to mean one thing and the newer convention means another
Old parts of our spec still use the boolean flag on a property and newer sections use the type array form instead. A reviewer unfamiliar with the history assumes one is a typo and fixes it, breaking a client that depended on the old form. We have a comment at the top of the file explaining the split and half the team still misses it.
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.