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" way
A commonly used way to version your API is to add a version number in the URL. For instance:/api/v1/article/1234
/api/v2/article/1234
The hypermedia way
GET /api/article/1234 HTTP/1.1
Accept: application/vnd.api.article+xml; version=1.0