Having versioning information in the headers should be as obvious as having it in the url when you are writing code that interfaces with the rest api. Url base

Having versioning information in the headers should be as obvious as having it in the url when you are writing code that interfaces with the rest api. Url based versioning is only more visible if you are accessing the api through a browser, in which case it's probably fine for the api to return the latest version since humans are pretty good at making sense out of new representations. I'm not sure I understand the benefit of url partials based routing. A REST api should be easily loadbalanced using a simple round robin setup since no state lives longer than a single request. Edit: Ok yeah, url partial based routing will allow you to implement v2 as an entirely new system.