Версионирование контрактов (API, интерфейсов) помогает управлять совместимостью между клиентами и сервисами. Изменения делятся на:

Совместимые изменения (не требуют поднятия мажорной версии):
- Добавление новых необязательных полей
- Добавление новых методов, которые не ломают существующий функционал
- Улучшения, не влияющие на существующие контракты
Несовместимые изменения (требуют поднятия мажорной версии):
- Удаление или переименование полей/методов
- Изменение типа данных в контракте
- Изменение семантики существующих методов

Таким образом, если изменение может сломать существующих клиентов, необходимо увеличить мажорную версию. Минорные и патч-версии используются для обратимо совместимых изменений и исправлений.

Версионирование контрактов — какие изменения требуют поднятия версии, а какие нет?