Versions Compared

Key

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

...

The following types of API versions are used throughout an API's life release cycle:

  • work-in-progress (wip) API versions used during the development of an API before the first pre-release or in between pre-releases. Such API versions cannot be released and are not usable by API consumers.
  • alpha (x.y.z-alpha.m) API versions (with extensions) for CAMARA internal API rapid development purposes
  • release-candidate (x.y.z-rc.n) API versions (with extensions) for CAMARA internal API release bug fixing purposes
  • public-release (x.y.z) API versions for publication as part of a meta-release. These API versions only have API version number x.y.z (semver 2.0), no extension. The public-release API can have one of two maturity states: 
    • initial - indicating that the API is still not fully stable (x=0)
    • stable - indicate that the API has reached a certain level of maturity (x>0)

...

The next sections provide the definition of terms used and the description of the life cycle stages of the API versionthe different API versions when moving through the release cycle.

Table of Contents

Definitions

...

Example: for the above url: {apiRoot}/qod/v2, the API name is qod.

API version

...

types

work-in-progress (wip) API version

...