Chapter 8 of 8 · 4 practices · 3 min · 4-question quiz
Versioning, deprecation and documentation
How to change an API without breaking the people who depend on it, and how to describe it so they can use it without asking you.
6 more chapters, 23 more practices, free with an account.
You have read the open chapters of the REST API Design Best Practices guide. Every chapter it covers is listed above, and an account opens the rest: each practice with why it matters, how to apply it and an example, with your progress saved as you tick them off. Early access is open: sign up and your account is active shortly after.
Everything here is free to learn from. A few things, like adding a roadmap, keeping a cheat sheet or asking Tauseef a question, use credits. You get 15 when you join, your first roadmap is free, and if you are learning seriously and run out, you can ask for more. Credits only make sure the platform goes to people who are actually learning.