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

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

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

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

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

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