URL path versioning

/v1/users. Visible. Cache-friendly. Many APIs use it. But every version = new URL space.

Advertisement

URL path versioning

/v1/users. Visible. Cache-friendly. Many APIs use it. But every version = new URL space.

Advertisement

Header versioning

Accept: application/vnd.myapp.v2+json. Cleaner URLs. Caches need Vary header. Confusing for casual API users.