Versioning web services: This is a good article on how to change a Web API without breaking things. I have this same problem right now — I have a REST API on a project, and I need to consider versioning.
When I add a new feature to Tagyu’s web service API, how should I best version it? I don’t want to maintain and support multiple, old copies of the API, but I also need to ensure I don’t break backward compatibility. A change to the API can’t cause existing apps out there to stop working.
You might also be interested in some follow-up articles...
Why web services versioning is important: Thoughts on the importance of versioned web services.
Versioning REST: Ideas on how to version a REST interface and examples of this implementation in Tagyu.