Download Latest Version
OAS 3.2.0 Released! source code.tar.gz (544.2 kB)
Get an email when there's a new version of OpenAPI Specification (OAS)
| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| OAS 3.1.0 Released!.tar.gz | 2021-02-16 | 239.6 kB | |
| OAS 3.1.0 Released!.zip | 2021-02-16 | 292.2 kB | |
| README.md | 2021-02-16 | 1.7 kB | |
| Totals: 3 Items | 533.5 kB | 0 | |
The OAI is pleased to announce the official release of the OpenAPI Specification 3.1.0!
Changelog
See 3.1.0-rc1 for previous changes in 3.1.0, including the explanation of why there are breaking changes.
Additions
- Added the
jsonSchemaDialecttop-level field to allow the definition of a default $schema value for Schema Objects.
Updates
- Updated some links to more accurate locations.
- Updates JSON Schema support to the latest 2020-12 draft.
- Revamped relative reference resolution under both URIs and URLs.
- Reworked file upload description to take into account new JSON Schema capabilities. This contains breaking changes.
- Both
x-oai-andx-oas-prefixes for Specification Extensions are now reserved to be defined by the OpenAPI Initiative.
Clarifications
- Path parameter values cannot contain the unescaped characters
/,?or#. - Further explanation of where Reference Object and JSON Schema's reference should be used.
- Unified wording when values are URLs/URIs.
- Reworded Path Item's
$refto take into account reference and component changes. - Fixed some examples.
- Minor text changes to improve consistency and readability.
- The description of the Reference Object has been updated to further clarify its behavior.
- Further updated Schema Object's description to take into account the latest draft, and the default use of https://spec.openapis.org/oas/3.1/dialect/base as the default OAS dialect.
- Reworded "Schema Vocabularies" to "Schema dialects"
