Come garantire la compatibilità retroattiva dell'API senza aumentare la versione? Cosa non si deve fare quando si modifica il contratto?

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

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

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

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

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