API Versioning
User support feels the most pressure whenever you introduce changes to your API. Whenever users have trouble consuming your API, they’ll reach out to support for help. API versioning is a way to anticipate the needs of consumers and inform them that changes are coming. By following a robust versioning and communication strategy, you can make your API easier to use and understand. Continue reading to learn how to apply the best strategy for your API.
This chapter begins by introducing you to the world of multiple API versions. You’ll revisit the different versioning strategies that you first learned about in Chapter 13. Then, you’ll continue learning how to have a default latest version and, at the same time, provide access to earlier revisions. You’ll see an example of how GitHub follows a similar strategy. You’ll then learn what a deprecation policy is and how to apply one to your API. You’ll see how to communicate the deprecation...