Как реализовать версионирование REST API?

Версионирование REST API нужно, чтобы менять контракт без поломки существующих клиентов. Три основных подхода: через URL (/api/v1/users), через заголовок (Accept: application/vnd.myapp.v2+json) и через query параметр (?version=2). URL-версионирование -- самый распространённый подход, потому что он прост и очевиден. Заголовки считаются «правильнее» с точки зрения REST, но менее удобны.