Версии и совместимость

Текущий контракт

У документированных маршрутов нет префикса версии URL. Документация привязана к исходным коммитам и выпуску документов. Версия пакета или Git SHA сами по себе не гарантируют ревизию работающего сервиса.

Справочник в репозитории создан из зафиксированной ревизии API. Живые /openapi.json и GET /endpoints описывают работающий сервис и могут отличаться во время развёртывания. Проверяйте различия до изменения интеграции.

Поведение клиента

Разбирайте нужные поля, допускайте дополнительные и обрабатывайте документированные null. Сохраняйте десятичные строки и используйте коды ошибок. Проверяйте изменения смысла полей, а не только имён.

Здесь не устанавливается фиксированный срок поддержки, период вывода из эксплуатации или гарантия совместимости. Тестируйте интеграцию при переходе на новую ревизию.