OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
Feedback from TSC Meeting: - [x] Rename "Fragments", suggestions: `Mappings`, `Expressions`, etc.. - [ ] **Reusability**, or the ability to add into `Components` - [ ] Initial proposal is somewhat...
(Not sure if this is the best place/right way to start this conversation, but would be interested in feedback.) TLDR: a way to include items in an API but marked...
Hello, there is a lot of JavaScript tooling that uses [AJV](https://github.com/ajv-validator/ajv/) to validate OpenAPI specs. None of it seems to support 3.1, which is really unfortunate. I was trying to...
with POST actions especially, there can be several unrelated operations that would be better presented to the user as separate POST actions in swagger-ui because they do very different things...
Hi, i forked [typescript DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped) repo and want to add `@types/openapi-specification` for typescript user who want to make tool depend on OpenAPI Specification. Can i use `@types/openapi-specification` name for types...
Hi! I would like to join to the Protocols and Payloads meta issue: Do you have any plans to support the [WAMP protocol](http://wamp-proto.org/)? > WAMP is an open standard WebSocket...
Hello, like described here (https://github.com/wordnik/swagger-ui/issues/380), path parameters are required and can't be optional. I use optional path parameters in a REST API for filtering, sorting etc. Example: www.example.com/users www.example.com/users:filter=active www.example.com/users:sort=name...
As of today, Open API spec [asserts that a path parameter should always be required](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#fixed-fields-7). This is a good assertion. However, we have some services in Azure that have optional...
Is it possible to have multiple 'Set-Cookie' headers in one response? As is known there are two ways to set cookies header in the response: - Having separated headers -...
Here are some updates for the `discriminator` keyword specification. Mostly, this update is to make it clear that `discriminator` shouldn't change the validation behavior of the `oneOf`/`anyOf` keywords. `discriminator` can...
