Skip to content

OAS 3.1.2 Released!
Compare
Choose a tag to compare
@lornajane lornajane released this 19 Sep 15:45
· 522 commits to main since this release
3.1.2
8260336
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.
Assets 2
Loading