Короткий ответ Breaking change — это изменение, после которого существующие клиенты API перестают работать корректно без изменений на своей стороне; его нужно анонсировать заранее, потому что клиентов обычно нельзя обновить мгновенно и одновременно с сервером. Как это работает подробнее К breaking change относятся, например, удаление или переименование поля в ответе, изменение типа поля, смена кода статуса ответа на другой смысл, изменение обязательности параметра. Такие изменения ломают код клиентов, которые полагались на старое поведение, даже если новый вариант «лучше» — для клиента важна предсказуемость контракта, а не абстрактная корректность. Пример кода Что использовать на практике Практика. Перед несовместимым изменением принято: уведомить потребителей API заранее, задать срок перехода, при возможности поддержать старое и новое поведение параллельно (например, через версионирование эндпоинта) и только потом удалить старое. Для внутренних API в рамках одной команды процесс может быть проще (достаточно
Загрузка…
