Step 5 of 6 83% complete

Version Your API

APIs evolve. Versioning prevents breaking existing clients.

Versioning strategies:

  • URL path: /api/v1/users (most common)
  • Header: Accept: application/vnd.api+json;version=1
  • Query param: /users?version=1

Recommendation: URL path versioning. Simple and explicit.

Only increment major versions for breaking changes.