OpenAPI-Specification

OpenAPI-Specification copied to clipboard

small improvements for the discriminator keyword, from the spec

karenetheridge

Examples map keys defined in components must adhere to a `pattern: '^[a-zA-Z0-9._-]+$'`. (Source: https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v3.1/schema.yaml) However, no such restrictions are defined on the examples map. This media type object seems allowed...

adamaltman

Adding Zuplo - a new API gateway with integrated OpenAPI designer, Developer Portal and TypeScript support for programmability.

joshtwist

I have been working on revamping the REST support in our storage engine and have worked on drafting an OpenAPI document during the process. On initialization of our storage engine,...

tristan957

Schema property alternative names

9

I would like to suggest to extend schema property by "alternativeName": ```yaml "type" : "object", "properties : { "property1" : { "type" : "string", "alternativeNames" : [ "Property1" ] }...

netbeansuser2019

For example, 50X is NOT permitted. This was fixed in v3.1 in PR#2690 but the change did not make it to v3.2.0.

karenetheridge

Open Community (TDC) Meeting, Thursday 25 August 2022

1

**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...

github-actions[bot]

Message format 'wrappers'

8

Some existing hypermedia formats (such as JSON API, HAL, JSON Collection) define a standard 'wrapper' for responses (not unlike the old SOAP envelope, in some ways). Current OpenAPI conventions are...

jharmn

Common response/payload object but different data defined per API?

4

What is the best way to represent a generic response/payload object that has basic fields such as message, total elements, data, and status? Where the variability between each API is...

atdiff

Aliasing query parameters

4

Consider the query parameter `query` in the following request: `https://my.api/api/endpoint?query=some%20query` I could document this parameter like so: ```yaml parameters: - name: query in: query description: Search term schema: type: string...

o-felixz