Re:How to Version an API
by smnscu on Friday June 09, 2017 @03:09AM
(#14519650)
Wrt your users, I think regardless of what scheme you use for API versioning it's a good idea to build libraries to access it – if you can afford it. [Go :), ]JS, PHP, C#, Java, Python, and Ruby, and you have most of the market covered. Then you can use semver for the libraries and the user doesn't care about how the actual endpoints look like – as an added bonus you can use more efficient encodings.
Example from a past life: https://github.com/lavab/api-client-js