OpenAPI-Specification icon indicating copy to clipboard operation
OpenAPI-Specification copied to clipboard

The OpenAPI Specification Repository

Results 476 OpenAPI-Specification issues
Sort by recently updated
recently updated
newest added

There are many parts of oData that can be supported by swagger easily. Worth investigating if the nuances are added to the future spec.

param serialization
media and encoding

Can there not just be a simple header generically at the response level not specific to each of the status codes? For our case, this kind of header is 99%...

re-use: globals/defaults

Hi, I working on an app which has a REST interface where I use LINK and UNLINK HTTP methods to send messages. I would like to use swagger for documentation...

http

This is a meta issue for tracking improvements for the structure of errors in OAS. Please don't add comments to this issue--rather open new tickets, if they apply, and reference...

error desc

Like other items that support the `$ref` syntax, would like to have $ref support for example values.

re-use: ref-everywhere

In the OpenAPI spec, section "XML Object", https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#xmlObject the examples show a default rule which I think is a bad decision. Consider the case (see also spec example at the...

xml
media and encoding

The specification says that `spaceDelimited` should be used for array or object values. How should an space be escaped when serializing into this format? ## Example Given the array `["Hello...

question
clarification
param serialization

**NOTE: This meeting is on Thursday at 9am - 10am PT** Zoom Meeting link: [https://zoom.us/j/975841675](https://zoom.us/j/975841675?pwd=SUh4MjRLaEFKNlI3RElpWTdhRDVVUT09). Dial-in passcode: 763054 - [Code-of-Conduct](https://github.com/OAI/OpenAPI-Specification/blob/main/CODE_OF_CONDUCT.md#code-of-conduct) In order to give some more visibility into the topics...

Housekeeping

Once its own new membership is established, @OAI/tsc needs to define * The process for adding to @OAI/triage * The criteria for being considered for @OAI/triage * The scope of...

Process