Версионирование и вывод из эксплуатации
Версия пути /api/v1 — это контракт.
Версия пути
Совместимые дополнения (новые поля, новые конечные точки) появляются внутри v1. Несовместимые изменения выходят только как v2.
Вывод из эксплуатации
Устаревшие конечные точки несут заголовки Deprecation, Sunset и Link на миграцию — минимум за двенадцать месяцев до отключения.
http
Deprecation: @1788480000
Sunset: Sat, 06 Sep 2027 00:00:00 GMT
Link: <https://www.claritos.io/developers/changelog>; rel="deprecation"Журнал изменений
Каждое изменение записано в журнале с версией и датой. Файл OpenAPI несёт ту же версию.