OAI/OpenAPI-Specification 3.1.2

OAS 3.1.2 Released!

on GitHub

Version 3.1.2 has no material changes but does contain editorial fixes, additional examples, and clarifications.

• Clarify that $ref in a Schema Object is a JSON Schema $ref keyword.
• Detailed explanation of percent-encoding and -decoding, updated examples and references to match, including the Style Examples table.
• Better explanation and examples for using Encoding and Serialization, and a note not to apply percent-encoding to headers.
• Clarify that Request Body Objects need to specify at least one media type to be meaningful.
• How to more clearly indicate that no response will have a body.
• How to handle null in XML as an advisory note; since the functionality cannot be changed it is implementation-defined for 3.1 tooling.
• Clarify that the root schema of an XML object should use the component name.