Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • API version type: refers to the life stage in the release cycle stages of an API: wip, alpha, release-candidate and public-release.
  • API version: (without or with an extension) is what is put in the version field in the API OAS definition file.
  • API version in URL (initial/stable): is a lowercase "v" followed by the MAJOR number from the API version. This is in the URL field in the Servers object in the API OAS definition file.
    • an exception is for an initial public-release API version (with x=0) where CAMARA allows that the URL may contain also the MINOR version number (separated by a "." (dot): v0.y.
  • API version can be released: A release can be created for the API version (with or without (for alpha) a release package).

...