ОбязательноOpenAPI

Совместимость API

Удаление поля или изменение его смысла требует совместимости со старыми клиентами.

Проверено Изменено

Плохо

amount вчера означал рубли, сегодня — копейки.

Хорошо

Новое поле amount_minor.
Старое поддерживается на время перехода.

Почему это важно

Клиент может продолжить работать без ошибки, но с неверными данными.

Когда применять

Срок перехода согласуется с потребителями. 90 дней — возможная политика проекта, а не универсальное требование протокола.

Кто что делает

Человек

Определяет поддерживаемых клиентов и срок перехода на новый контракт.

AI-агент

Реализует серверный контракт и проверяет успешный запрос, неверный ввод и повторное обращение.

Контроль результата:

  • Старый клиент проходит контрактные тесты новой версии?

Как проверить у себя

  • Старый клиент проходит контрактные тесты новой версии?
ПервоисточникиИстория изменений на GitHub

Дата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.