-
It's obvious that each api will have a bunch of errors. Each request can usually raise one of several errors (where subsets can differ for different routes).
Current scheme allows only one response wi…
-
Current description of **operationId**
_Unique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools…
-
This looks to me like a very useful feature, and i'm not sure why it was closed. Is it abandoned ?
Anyway, allow me to expose a legitimate usecase that only this nesting feature would fulfill (as f…
-
Hi, the spec says:
> The discriminator object is legal only when using one of the composite keywords `oneOf`, `anyOf`, `allOf`.
What's the meaning behind something like this?
```yaml
components:…
-
Hi All,
Suppose i have a resourse Dog and a Resource Owner. i can design Dog in openapi in the following way:
1)
```
Dog:
type: object
required:
- id
- name
…
-
Hi,
we would like to use TypeSchema as an alternative schema at an OpenAPI specification.
[TypeSchema](https://typeschema.org/) is a JSON format to describe data models.
To describe a little b…
-
The spec forbids the use of $refs to define entries in the `servers` array. The unfortunate result of this is duplication of information in several specification files, even though the services define…
-
## Weekly meetings happen on Thursdays at 9am - 10am Pacific
This agenda gives visibility into discussion topics for the weekly Technical Developer Community (TDC) meetings. Sharing agenda items in a…
-
I was surprised to find that the default value of a parameter needs to be expressed as `default` property on the parameter's `schema`. This confuses type default with endpoint parameter defaults. The …
jbee updated
4 months ago
-
Context: I'm implementing support for `examples` in an OpenAPI tool.
I have a pretty good working knowledge of the Specification, but to make sure I didn't miss anything, I Cmd+F'd the 3.0.2 docume…