Предпочтительна эволюция одной схемы: nullable новые поля, @deprecated, избегайте breaking non-null изменений; при необходимости — отдельный endpoint/gateway path, не /v2 на каждое поле.
Разбор
- Удаление поля — breaking для клиентов.
- Смена типа поля почти всегда breaking.
- Мониторьте usage полей перед удалением.
- Кодоген клиенты помогают найти разрывы.
Итог
Эволюция схемы важнее «версий URL»; breaking — редко и осознанно.
