Movatterモバイル変換

[0]ホーム
URL:

Skip to main contentLinkMenuExpand(external link)DocumentSearchCopyCopied
OpenAPI Initiative Publications
This site usesJust the Docs, a documentation theme for Jekyll.

OpenAPI Specification

Specification Versions

Schema Iterations

Note that while schemas can catch many errors, they are not guaranteed to catch all specification violations. In the event of a disagreement between the schemas and the corresponding specification text, the specification text is presumed to be correct.

A minor release (e.g. v3.1) has one or more published schemas, identified with the release 3.1 and a revision date like 2021-03-02. All schemas for a given minor release apply to all patch releases within that minor release (e.g. 3.1.0, 3.1.1, 3.1.2, etc.). The dates are purely a way to uniquely identify the revision, and are not intended to be correlated with patch release publication dates. The latest date within a minor release is always the most correct schema for all patch releases, and previous revisions are obsolete.

Note that the v3.1+schema/YYYY-MM-DD schemas donot validate the Schema Object, as they make no assumptions about the JSON Schema dialect in use. The v3.1+schema-base/YYYY-MM-DD schemasdo validate the Schema Object, and require that ifjsonSchemaDialect or$schema are present, that they use the appropriatedialect/YYYY-MM-DD. The nameschema-base comes from the JSON Schema dialect including the OAS extensions being referred to as the “base dialect” in the specification.

Seeissue #4147 for discussion of other possible JSON Schema dialect options,issue #4152 for programmatic access to the latest schemas, andissue #4141 for discussions on possibly providing linting schemas that could catch likely problems that do not directly violate the specification.

[8]ページ先頭
©2009-2026 Movatter.jp