Skip to content

OAS 3.0.0-rc0 Released!

Pre-release
Pre-release
Compare
Choose a tag to compare
@webron webron released this 01 Mar 01:04
3.0.0-rc0
d232e6d

We're happy to announce the release of the first Implementer's Draft of OAS 3.0.0, known as 3.0.0-rc0.

A lot of changes in this release, as a first one goes, so expect the change log to be updated. An initial list of changes, in no particular order:

  • Changed the versioning scheme of the spec.
  • Reusable definitions in the spec has been expanded and reorganized under the Components Object.
  • Added support for operation callbacks.
  • Added support for a new static linking between responses and operations.
  • Reworked parameters - removed formData parameters, added cookie parameters, changed body parameters to Request Body Objects as a separate entity.
  • Parameters now support complex types.
  • Responses support multiple media type specifications.
  • Reworked file support. Dropped file as a type, but provided better handling for file uploads and downloads.
  • Reworked security definitions to allow for support for more schemes.
  • Improved support for examples throughout the spec.
  • Added support for defining multiple servers hosting the API, including URL variables.

Check it out! https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc0/versions/3.0.md

Our blog post contains more details of the process and next steps.

Assets 2