API Design · Middle · Question 28 of 75

What are trade-offs of URL versioning (`/v2/...`) versus header versioning?

1URL versioning breaks caching
✓Correct answer: URL versions are visible, easy to route and cache, but encourage big-bang versions; header versions keep URLs stable but are less discoverable
3Header versioning is not allowed by HTTP

Explanation

Some APIs (Stripe) version by date per account, letting each client upgrade on its own schedule.

Further reading

Test yourself

Take the API Design · Middle quiz: questions and options are shuffled, and you get a review of your mistakes at the end.