OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
This issue is quite simple it's only about moving the root `externalDocs` into the `info` object to simplify root. before: ``` YAML info: # (existing) info object externalDocs: # link...
Following (again) ideas from OAI/OpenAPI-Specification#563 and OAI/sig-moonwalk#115, extending OAI/OpenAPI-Specification#369: - define reusable response headers (like parameters or definitions as proposed in OAI/OpenAPI-Specification#563 by @fehguy ) - set responses headers on...
Currently, the Swagger 1.2 specification supports three authorization schemes: basic authentication, API key and OAuth2. One popular scheme that is missing is [OAuth 1.0](http://tools.ietf.org/html/rfc5849); can it be added to the...
In the spec currently this is valid: ```yaml type: object required: - name properties: name: type: string ``` However, this is not: ```yaml type: object readOnly: - name properties: name:...
Note: *This issue has been discussed before - but will make an attempt to re-propose supporting error and warning meta information.* **The Proposal - Summary** Adding the support for error...
In a separate document. Has a separate lifecycle. How does the overlay reference the source document? - By document structure Is OperationId a valid way of referencing core documents?
This is a question about the specification, and the intent of the following description in the [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#fixed-fields-20), relating to the `xml` property: > This MAY be used only on...
Discussed on TSC Meeting: April 2, 2018: Rules and test cases in a conformance test suite might have a descriptive structure, something like this: * Rule description (human-readable) * Reference...
I just created an example to illustrate what I think is idiomatic use of `discrimator`, so I could help answer #2141. I find it helpful to use [JSON Schema Lint](http://jsonschemalint.com)...
A media type of `application/swagger+json` has been [suggested on the mailing list](https://groups.google.com/forum/#!searchin/swagger-swaggersocket/application$2Fswagger$2Bjson/swagger-swaggersocket/Xd5cWuTusVs/QyRTUlS8Xi4J) before. I would recommend formally declaring this as part of the spec. RAML [defines its media type](http://raml.org/spec.html#overview) as...
