OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
This pull request is automatically triggered by GitHub action `respec`. The versions/v*.md files have changed, so the HTML files are automatically being regenerated.
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot] avatar"){kind=avatar}
* 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...
* Ports #3714 * Fixes #3601 Includes an example. This intentionally does not explain how dynamic referencing works, as there are better resources available in both the spec and (more...
I was surprised to find that the default value of a parameter needs to be expressed as `default` property on the parameter's `schema`. This confuses type default with endpoint parameter...
Hello! I'm trying to use the OpenAPI 3.0 spec to document an API that supports a subset of the [Resource Query Language (RQL)](https://github.com/persvr/rql#rql-rules). However, because this query string format doesn't...
Regarding ``[`` and ``]`` must be urlencoded, I propose the usage of dot notation to serialize arrays and objects at query parameters. Having the following array: ```json { "x": ["b","d","f"]...
TL;DR: I have no idea how to define compliance criteria for `allowEmptyValue: false`, which is the default behavior, with setting `true` being NOT RECOMMENDED. <rant> The clarification added in 3.0.2...
We added a note about case insensitivity in v3.1.1 (see #2644 ), add it to 3.0.4 as well.
## Weekly meetings happen on Thursdays at 9am - 10am Pacific This agenda gives visibility into discussion topics for the weekly Technical Developer Community (TDC) meetings. Sharing agenda items in...
This is sort-of a port of #3732, but modified because the scenario involved was mostly assumed to be valid based on the more direct text of OAS 2.0. So instead...