OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
Splitting this out from #3766, to which it is still somewhat related as we should consider the impact on how many PRs to how many different branches are required for...
The current mechanism to provide examples for artifacts in a swagger spec is fragmented. It does not give the consumer an overview (or a bird's eye view) of an example...
There are a number of issues regarding support for security controls which do not fall neatly under the "apiKey", "http", "oauth2", "openIdConnect" taxonomy. This suggests that we need a more...
## Background: During the TDC Meeting on 2/15/2024, I raised the point of contributing to the namespace registry. In particular, I wanted to add the extension for AWS ```x-amazon-```. This...
https://spec.openapis.org/registry/extension/index.html lists `x-twitter` (which now could become `x-x`...) and there is no published/referenced spec. Just out of curiosity, what's the data type of that extension and assuming it's a string,...
Closes https://github.com/OAI/OpenAPI-Specification/issues/3717 **What I have done:** 1. Go to `gh-pages` and move all files under the `docs` folder which Github supports. 2. Go to `main` branch and run `git merge...
This issue consolidates the various interrelated branch / merge / publish / etc. we need to sort out, as discussed in the Moonwalk 19 March and TDC 21 March meetings....
This script does the following. 1. Switch to the 'gh-pages' branch. 2. Copy "schemas/v{major}.{minor}/schema.json" in the 'main' branch to "oas/{major}.{minor}/schema/{YYYY-MM-DD}" in the 'gh-pages' branch. The value of {YYYY-MM-DD} is extracted...
Having to always denote the same xml properties over and over again, namely the prefix and the namespace on properties and data types alike, one should instead be able to...
Can we move the examples in this repo (that are not part of the spec) either to the learn site or to the spec site (run from gh-pages, but see...