This question still needs answering. If you like to help, make a pull request for this question.
What is the correct way to version my API?
The "URL" wayA commonly used way to version your API is to add a version number in the URL. For instance: To "move" to another API, one could increase the version number:
The hypermedia way