OAI / OpenAPI-Specification Public

https://spec.openapis.org/oas/v3.1.0#responses-object

https://spec.openapis.org/oas/v3.1.0#fixed-fields

in v3.1 the number of schemas increased considerably, which can be a bit confusing.

Add `schema2dts`, `whook` and `openapi-ts-sdk-builder` to implementations.

Merging as discussed on the spec call today.

/info/termsOfService: https://spec.openapis.org/oas/v3.1.0#fixed-fields-0
/contact/url, email : https://spec.openapis.org/oas/v3.1.0#fixed-fields-1
implicit/authorizationUrl: https://spec.openapis.org/oas/v3.1.0#fixed-fields-24
authorizationUrl, tokenUrl, refreshUrl: https://spec.openapis.org/oas/v3.1.0#fixed-fields-24

* allowEmptyValue is valid only for query parameters

https://spec.openapis.org/oas/v3.1.0#parameter-object

we can't move this to the dependentSchemas section because that is only valid
when "schema" is present.

* allowReserved only applies to parameters with a value of query

https://spec.openapis.org/oas/v3.1.0#parameter-object

https://spec.openapis.org/oas/v3.1.0#example-object

Add restful-react to list of implementations.

* Update Proposals 003 "Clarify Nullable" to approved status

The proposal was adopted in OpenAPI version 3.0.3. This pull request updates the proposal with that status change.

* Conformance with the standard proposal format. 

Changed status to 'Promoted' in accordance with the proposal template.

Co-authored-by: webron <webron@users.noreply.github.com>

Following the standardization of the table headers' formatting in 746b830, a slight deviation was reintroduced in 5984314.
This commit re-normalizes the headers so they're consistent again.

* Change server-variable property to 'description'

According to the spec: https://spec.openapis.org/oas/v3.1.0#server-variable-object

This should validate a `description` field, not `descriptions`.

* Update schema.yaml

Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com>

Also normalize whitespace in table headers

Project's url https://github.com/OverSpeedIO/koa2-oas3 shows 404. Can't find the project through google either. Looks like the project closed.

- name is required (for parameter)
- the map under content must contain only one entry

as per https://spec.openapis.org/oas/v3.1.0#fixed-fields-9

2nd attempt at this. Adding ".md" suffix. Intended to be a place for all our SIGs to better define who they are, how to join, expectations, etc.

* Update 3.1 schema id for patch release

* Generate JSON for new version of 3.1 schemas

* Catchup v3.0 schema with #2158

* Catchup v3.0 schemas with #2673

* Catchup v3.0 schemas with #2706

* Update schema id for 3.0 release

https://spec.openapis.org/oas/v3.1.0#pathTemplating
"The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#)."

If the wrong type is used for a particular piece of data, then a bare
"required" will validate as true, causing the "if" clause to be true, which
can lead to confusing errors when the "then" schema then fires, instead of the
error occurring at a higher position in the schema.

https://spec.openapis.org/oas/v3.1.0#patterned-fields-0

* minor simplification of v3.1 schema

"if the X property is present, then apply this constraint to property X" can
be simplified by simply stating the constraint for property X.

* add missing constraint to "header"

https://spec.openapis.org/oas/v3.1.0#headerObject

* allowEmptyValue and allowReserved don't make sense for headers

* collapse single-item "enum"s in "cookie" and "header" to "const"

generated via:
perl -MYAML::XS -MJSON::MaybeXS -we'$YAML::XS::Boolean="JSON::PP"; print Dump(JSON::MaybeXS->new->decode(do { local $/; <> }))' input.json > output.yaml

* fix: typo spelling grammar

* Update proposals/2019-07-17-Webhooks.md

change ``request`` to ``requests``

Co-authored-by: Nate <37554478+servusdei2018@users.noreply.github.com>

Co-authored-by: Nate <37554478+servusdei2018@users.noreply.github.com>

This makes metaschema consistent with the 3.0.x spec.

Refs #2666