OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
The [style values](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#style-values) table has a `type` column which I _assume_ indicates which data types can be serialized using that style (e.g. a `deepObject` style on a query parameter for...
given we handle a lot of Open API specification given the fact that contact are mostly always the same it would be great that $ref being supported for the field...
For example, as [described in the guide](https://swagger.io/docs/specification/describing-request-body/multipart-requests/), in a request such as ```http POST /upload HTTP/1.1 Content-Length: 428 Content-Type: multipart/form-data; boundary=abcde12345 --abcde12345 Content-Disposition: form-data; name="profileImage"; filename="image1.png" Content-Type: application/octet-stream {…file content…}...
Hi, Is there any reason why the non-standard refreshUrl property was added to OAI? Obtaining a new Access Token using the Refresh Token should be done using the TokenEndpoint, as...
Webhooks were added in addition to callbacks in OAS 3.1 with this proposal: https://github.com/OAI/OpenAPI-Specification/pull/1974 I understand callbacks to be typically delayed responses to a request - hence one provides a...
We know we want to do a 3.2 release, and talked in this week's TDC Call about the possibility of further 3.x releases. As with the patch releases (see #3528),...
Considering there are several tools out there for generating both client-side and server-side code from your OpenAPI spec, defining timeouts would be a useful feature, imo. I would think an...
HTTP Header names are case insensitive. Swagger specification enforce to be case sensitive all field names without exceptions. > All field names in the specification are case sensitive. > >...
Hello! According to [the specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#headerObject) header object (in components section) must not include a `name`, the name is derived from the `headers` map's key instead. But, what if I want...
[RFC 5988, section 5](https://tools.ietf.org/html/rfc5988#section-5) is defining the `Link`HTTP header. It is mainly used on responses to GET requests (but can happen on any kind of response), but can also be...
