...
Precedence example: 1.0.0-alpha.1 < 1.0.0-alpha.2 < 1.1.0-alpha.1 < 1.1.0-alpha.2 < 1.1.0-rc.1 < 1.1.0-rc.2 < 1.21.0 (public-release)
NOTE: a public-release API version shall have no extensions, only the major.minor.patch version number as described in the previous section.NOTE: alpha and beta extensions shall not used (as no clear criteria are identified). Only the extensions needed for release management shall be used.
API version in URL
The API guidelines contain the following approach for defining the API endpoint URL:
...
Once a public-release API version is created and externally published published as part of a meta-release, the API version in the URL of a released API shall ONLY contain the MAJOR digit of the API version, e.g. "v2" in the above example.
...