Гайды
Версионирование
Стратегия версий API, deprecation, заголовки.
Раздел в работе.
API поддерживает версионирование через URL-prefix /api/v1/. Версия объявляется в заголовке ответа X-API-Version. Удаляемые эндпойнты помечаются Deprecation и Sunset (RFC 8594).