API versioning — способ поддерживать несколько версий API одновременно, чтобы не ломать старых клиентов при изменениях. Самые популярные подходы: версия в URL (/api/v1/users, /api/v2/users), в заголовке (Accept: application/vnd.api+json;version=2) или через query-параметр. В URL — самый простой и наглядный, его используют чаще всего. Главное правило — новая версия не должна ломать старую, а старую нужно поддерживать какое-то время и дать клиентам мигрировать. Без версионирования любое изменение API — потенциальный breaking change.