Вступить в клуб →

Новое обязательное поле в запросе сломало партнёров

В эндпоинт POST /v1/shipments добавили обязательный параметр warehouse_id, обновили Swagger-описание и выкатили в прод. Через час партнёрские интеграции массово получают 422 и перестают создавать отправления.

Какое утверждение верно?

  • Новое обязательное поле в запросе — ломающее изменение: его вводят опциональным со значением по умолчанию либо в новой версии эндпоинта
  • Добавление поля в запрос не ломает клиентов ни при каких условиях; ломающими считаются только изменения структуры ответа
  • Достаточно обновить OpenAPI-спецификацию и разослать её партнёрам: клиенты подтянут новый контракт и начнут слать поле
  • Нужно вернуть код 400 вместо 422: старые клиенты трактуют его как временную ошибку, повторяют запрос и продолжают работать

Проверка ответа — в клубе

  • Мгновенная проверка ответа
  • Подсказка, если застряли
  • Разбор с объяснением, почему так
  • Прогресс по всем задачам и виртуальные собеседования
Зарегистрироваться →

регистрация занимает минуту

Другие задачи раздела