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.