The Linux Foundation Projects
Skip to main content

Repo

The Open API Initiative’s Technical Developer Community has announced a v3 release timeline.

Get details here:

  • May 22 through June 16: Resolve remaining pull requests (4 weeks )
  • June 19 through June 30: Comment period (2 weeks)
  • July 3 through July 14: Resolve remaining comments and issues (2 weeks)
  • July 17 through July 21: TENTATIVE release window (1 week)

The OpenAPI Specification can be used by any individual or organization free of charge. There are no membership requirements to implement the specification. The latest version of the specification can be found on GitHub. Anyone looking to get involved in developing the spec can join in conversation there.

The latest version of the Spec is divided into a series of Meta issues

  1. Documentation cleanup
  2. Specification documentation structure and supporting docs
  3. Protocols and Payloads
  4. Security
  5. Unique path definition
  6. Restructure request parameters
  7. Structural improvements

Who Oversees the OAS?

The OAS is constantly being evolved by the API community. Development of the spec is driven by the Technical Developer Community, a body comprised of representatives from the members of the Open API Initiative as well as non-member representatives.

The goal of the OAI specification is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.