Versioning REST Web Services

, May 17, 2008

Peter Williams:

Managing changes to APIs is hard. That is no surprise to anyone who has ever maintained an API of any sort. Web services, being a special case of API, are susceptible to many of the difficulties around versioning as other types of APIs. For HTTP based REST style web services the combination of resources and content negotiation can be used to mitigate most of the issues surrounding API versioning.

In another post on the topic, Peter addresses the downsides of the approach he suggests (relying on custom media types).