¿Cómo garantizar la compatibilidad hacia atrás del API sin aumentar la versión? ¿Qué no se debe hacer al cambiar el contrato?

Обратная совместимость без поднятия версии API достигается за счёт:

• Добавления новых необязательных полей, которые старые клиенты могут игнорировать.
• Не удаления и не переименования существующих полей.
• Поддержки старых форматов запросов и ответов.

Что нельзя делать при изменении контракта:

• Удалять или изменять смысл существующих полей.
• Изменять типы данных полей.
• Изменять обязательность полей (делать обязательные поля необязательными или наоборот).

Таким образом, клиенты, использующие старую версию API, продолжат работать без сбоев, а новые смогут использовать расширенный функционал.