Версии и совместимость
Адрес каждой ручки начинается с номера версии. Внутри версии ломающих изменений не бывает.
Мы можем добавить в ответ новое поле или новую ручку — это не считается ломающим изменением. Разбор ответа должен переживать появление незнакомого поля.
Удаление поля, переименование и смена типа выпускаются только следующей версией пути.
Машинный источник истины — спецификация OpenAPI. Клиенты и типы удобнее генерировать из нее, а не переписывать руками со страницы.