Hoe zorg je voor backward compatibility van de API zonder de versie te verhogen? Wat mag je niet doen bij het wijzigen van het contract?

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

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

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

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

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