One main purpose of versioning APIs is so that we can introduce changes in the API signature (in some cases breaking backward compatibility). We put the major version in the endpoint string itself, for example:
"basePath": "/tmf-api/serviceCatalogManagement/v4/",
and we put the full version as a swagger attribute in the "info" section, for example:
"version": "4.0.0"
This versioning allows an implementation to continue supporting a given older version, or multiple versions, of the API, and a consumer to request a specific major version by setting in the endpoint.
Hope it helps
------------------------------
Jonathan Goldberg
Amdocs Management Limited
------------------------------