OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
For documentation purposes, it would be wonderful if we could add href-type links in Swagger annotations. The purpose of these links would be to reference one API call from another...
Per this question: http://stackoverflow.com/questions/27004847/provide-alternate-international-spelling-for-defined-swagger-route/27013027#27013027 It would be great to allow aliasing of route paths for such uses as international spellings of words
This may be similar to #166. Currently there is no way to indicate whether a ResponseObject is an error or not. In the pet store example a "default" response is...
It's obvious that each api will have a bunch of errors. Each request can usually raise one of several errors (where subsets can differ for different routes). Current scheme allows...
In our application, we have apis divided among various modules. As per swagger-spec, It becomes very difficult to have only one swagger file (api-docs) for all the modules considering the...
Related to [#51](https://github.com/OAI/OpenAPI-Specification/issues/51) We have identified in the market a need for measuring and enforcement SLA in APIs. Specially, API vendors would benefit from an standard import of SLA metrics...
In providing quality documentation, it's necessary to provide more than "400 - Bad Request". Usually, an error object defines a key which indicates more specifically what was wrong (this applies...
The spec allows this, but I wonder in practice if this would ever be supported. I mean, would it be possible to merge `www-authenticate` headers in responses or read multiple...
In a similar vein to #677: I'd also like to see support for references in `securityDefinitions` - again I have several APIs scattered across a number of files, and it...
Based on @fehguy structure modification proposition on #563 and my ideas gathered while writing OpenAPI spec and writing my OpenAPI spec tutorial, I propose a new structure for the document....
