João Freitas

The following is an analysis of API versioning - the process of labeling an API that will be upgraded, which the deprecating API must still properly work to existing consumers. The author provides some questions developers should ask themselves to support API upgrading, as well as some tips on how to achieve API versioning.

Imagine you have a RESTful API that has been serving thousands of users. You’ve been maintaining the code, and now it’s time to add a critical new feature – versioning. Often overlooked, API versioning is probably the most important part of the API infrastructure.

It’s something that you should probably think about even at the earliest stages – not that all API endpoints and behavior need guarantees at that stage (and shouldn’t). Still, versioning is easier earlier rather than later.  

A few considerations:

A few versioning strategies.

#reads #matt rickard #architecture #api #versioning