OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
According to the [spec](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterExplode), "When `style` is `form`, the default value [for explode] is true. For all other styles, the default value is false." However, according to [this documentation](https://swagger.io/docs/specification/serialization/), in...
Hello there. Can we get some clarification on: - cookie parameter example values using form serialization - rfc6570 template clarification for all style and parameter type combos? I am asking...
The OpenAPI 2.0 Specification states that its goal is [“to define a standard, language-agnostic interface to REST APIs”](https://github.com/OAI/OpenAPI-Specification). REST is an extremely popular style for implementing APIs that run over...
Hello, I have two endpoinds 1 - Returns single Object 2 - Returns arrays of objects  I would like to use same SearchResultResponseExample for both endpoints, but in code...
I've come across the requirement of defining an _immutable_ field, that is, one that can only be set when the resource is created (POST). The field is not allowed to...
It would be useful if you could tag schema properties and parameters as being sensitive or PII specific so that these could be tagged appropriately in API docs.
Currently, OpenAPI allows us to identify the version of the API being described and deprecate operations using a Boolean value. I would like to propose some additional metadata that makes...
Is it possible to group parameters ? For ex: Header "address" has parameters street,city,state
#### Idea Sometimes you have some parameters you want to provide on every path. At the moment it is possible to reference them with the `$ref` tag. This works great...
Suppose we have such OpenAPI document which served by location http://example.com/openapi/desc ```yaml servers: - url: 'http://example.com/' components: schemas: Pet: type: object required: - petType properties: petType: type: string discriminator: propertyName:...
