Сервис поставщик хочет добавить значение PAUSED в поле статуса ответа API, считая изменение расширением. В каких случаях это нарушит контракт с потребителями и как это следует проверить?

Question

Accepted Answer

Для ответа API новое значение перечисления потенциально обратно несовместимо: старый потребитель мог обрабатывать статус как закрытый набор значений. Например, клиент с исчерпывающей ветвлением логикой, строгой десериализацией или бизнес правилом для известных статусов может завершиться ошибкой либо принять неверное решение. Контрактное тестирование должно проверять не только структуру поля, но и способность каждого потребителя корректно обработать новое значение или явно согласованный сценарий его появления. Добавление значения в перечисление безопасно только если контракт допускает неизвестные статусы и потребители действительно реализуют такую обработку. Направление важно: расширение допустимых значений в запросе обычно расширяет возможности клиента, а появление нового значения в ответе навязывает его обработку существующим клиентам.