Skip to content
  • Versioning · API Design

Versioning

LearnViaNotes @learnvianotes· 1 min read

Once clients depend on your API, you can never break them. Versioning lets you evolve the API while keeping old consumers working.

Versioning strategies

URL path

GET /api/v1/users/123
GET /api/v2/users/123
// v1 and v2 run simultaneously

Request header

GET /api/users/123
X-API-Version: 2

Query param

GET /api/users/123?version=2

Deprecation policy

Free for students and teachers

Write notes like this one

Cards for every idea, quizzes and flashcards, read aloud — on the web and your phone.

Something wrong with this note? Open it to report