Chris Pitt has a new tutorial giving tips on versioning of an API:
Imagine that you have just built an API and a few weeks after release, analytics show that many users cross-post their content to Medium. So the client tells you that every new user must have a link to their Medium profile.
If you alter the current API then it could break consumers. So today I’ll show you one of the most sensible aspects of building an API: practical versioning.