As part of this release, we have decided to not follow SemVer anymore, and as such introduce breaking changes. These changes are documented as part of the release notes.
Additionswebhooks
. This allows describing out-of-band webhooks that are available as part of the API.summary
field.identifier
field for SPDX licenses.pathItems
, to allow for reusable Path Item Object
s to be defined within a valid OpenAPI document.null
.object
type
for spaceDelimited
and pipeDelimited
style
values.style
, explode
and allowReserved
for multipart/form-data
media type as well.webhooks
support, expressions in the Callback Object
can now also reference Path Item Object
s.summary
and description
fields can now be overridden.Breaking Changes
mutualTLS
) as a security scheme.paths
, components
or webhooks
to exist at the top level. While previous versions required paths
, now a valid OpenAPI Document can describe only webhooks, or even only reusable components. Thus, an OpenAPI Document no longer necessarily describes an API.$ref
is inherently part of the Schema Object
and has its own defined behavior.x-oas-
are now reserved for the OpenAPI Initiative.format
is now not validated by default.nullable
keyword has been removed from the Schema Object
(null
can be used as a type value).exclusiveMaximum
and exclusiveMinimum
cannot accept boolean
values (following JSON Schema).required
and readOnly
/writeOnly
in relation to requests and responses.format
(whether byte
, binary
, or base64
) is no longer used to describe file payloads. As part of JSON Schema compliance, now contentEncoding
and contentMediaType
can be used for such specification.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4