Как обеспечить обратную совместимость API без поднятия версии? Что нельзя делать при изменении контракта?

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

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

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

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

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