OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
## Issue In some APIs, different query string values specifies the operation done on the resource, thus, result in dramatically different response types and/or parameter requirements. In the case of...
3.0.2 spec section [Support for x-www-form-urlencoded Request Bodies][1]: > To submit content using form url encoding via [RFC1866][0], ... And, [RFC1866 section 8.2.1 The form-urlencoded Media Type][2]: > The form...
**Background** Many applications expect deeply nested objects in input parameters, see the discussion in swagger-ui starting from this comment: https://github.com/swagger-api/swagger-ui/issues/4064#issuecomment-357417513 In [LoopBack](https://loopback.io), we are running into this problem too, see...
Hello there, I got a small question about the compoments[parameter] Currently, im trying to make some parameters reusable and the basic seems pretty simple. ``` # openapi: 3.0.1 info: title:...
The second-to-last entry in the examples table of section [Key Expression](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#key-expression) should be Expression | Value ---|:--- $request.body#/successUrls/**1** | http://clientdomain.com/medium [RFC6901](https://tools.ietf.org/html/rfc6901) uses zero-based indexing, so **1** references the second item...
Hi! I'm not in the business of making APIs myself, so I don't know how helpful I can be. However, I found that [RFC8628](https://tools.ietf.org/html/rfc8628) offers a "Device Code" type of...
The [operation object](https://spec.openapis.org/oas/v3.0.3#operation-object) allows folks to specify parameters, but how can I express that no unnamed parameters may be accepted? We've had issues where clients are passing in query parameters...
This is a meta issue representing a number of requests over the years including #1459 #1840 #892 Currently the OpenAPI specification does not allow optional path parameters nor path parameter...
In the [Licensing](https://github.com/OAI/OpenAPI-Specification#licensing) section at the bottom of the readme file, the analytics image is broken.  Clicking on the link to the image itself shows the error message "Error...
