When developing REST APIs, it’s not uncommon that there are breaking changes that need to be made, potentially affecting the contract or behavior of the endpoint.

The issue with making breaking changes is that consumers will be affected, whether they need to quickly change their application to address your breaking changes, or have unexpected behavior that previously didn’t occur. Regardless of the impact, it’s not practical to make breaking changes without supporting the previous version.

That is where versioning comes in. Versioning allows you to have different versions of endpoints that are simultaneously active. It allows developers to make a…

Richard Lee

I’m a Software Engineer who has some occasional good ideas. Follow if you’d like to hear (read?) about them!

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store