OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
In https://spec.openapis.org/oas/v3.1.0#fixed-fields-9: "If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored." Should this also include "Cookie" and/or "Set-Cookie", since these...
Hi, I need to use Cookie Authentication for my APIs, but the authentication cookie name's in my app changes every time you log in (only the cookie name prefix is...
## I expect A way to express structured-fields serialization rfc8941 - https://httpwg.org/http-extensions/draft-ietf-httpbis-header-structure.html Here are some examples: ``` Example-IntegerHeader: 42 Example-BoolHdr: ?1 Example-StringHeader: "hello world" Example-BinaryHdr: :cHJldGVuZCB0aGlzIGlzIGJpbmFyeSBjb250ZW50Lg==: Example-StrListHeader: "foo", "bar", "It...
hi, I just wanna know, Are the batch operations such as put, post allowed in the openapi? supposed that, if I put/post some objects in a batch operation, and during...
I'm try to define a oai spec for a rest api. but I don't know how to define the array with serial data response as followed ``` { "status": 0,...
Hi All, suppose we have two model Author and Resource : ```yaml Author: type: object properties: id: type: string readOnly: true name: type: string required: - id - name Book:...
In the OpenAPI spec, section "Link Object", https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#linkObject the "Examples" table following after the text "The table below provides examples of runtime expressions and examples of their use in a...
* Ports #3760 * Fixes #1542 This makes the relational requirements of `content` vs `schema` and associated fields more clear. The mutual exclusivity requirement is moved up to the top...
Closes https://github.com/OAI/OpenAPI-Specification/issues/3703 i have changed the format of the `base_type` in the produced JSON to array for all the formats since I think we should be consistent with the property...
Check existing non-RFC links whether they are normative or informative, for example links to the YAML specification, or links to the JSON Schema specifications. Add appendix "Informative references" for selected...
