Лидпульт

HTTP-код ответа: как читать

HTTP-код — трёхзначное число в начале ответа сервера. Оно сообщает, что случилось с запросом: принят, отклонён из-за ваших данных или не обработан из-за сбоя на стороне сервера.

Определение

Первая цифра задаёт класс ответа. 2xx — успех, 3xx — перенаправление, 4xx — ошибка в запросе (вина отправителя), 5xx — ошибка сервера. Код читает программа, а пояснение для человека лежит в теле ответа.

Как это выглядит в Лидпульте

Принятая заявка возвращается с кодом 200 и JSON { "status": "ok", "lead_id": … }. Отказы идут с кодами 4xx и полем code: 400 bad_request, 401 bad_key, 403 blocked или geo_closed, 404 offer_not_found, 409 offer_not_live или duplicate, 422 city_not_found или bad_phone, 429 limit_reached.

Когда повторять запрос

  • Ошибка сети, таймаут, ответ 5xx — повторять имеет смысл, лучше с тем же apiid.
  • Любой 4xx — повтор бессмысленен: ошибка в данных или условиях не исчезнет.
  • 429 с кодом limit_reached: лимит на сегодня исчерпан, следующий приём возможен после наступления нового дня по Москве.

Пример из практики

Трекер получил 409 с кодом offer_not_live. Вебмастер, видя это в журнале, понимает, что оффер на паузе, и останавливает трафик, а не гоняет заявки впустую.

Нюансы

Смотрите и код, и поле code: один HTTP-статус может соответствовать нескольким причинам. Не считайте 200 с телом status: error успехом. Если интеграция умеет только по HTTP-коду, настройте её на 2xx как «успех».

Практический совет

Заведите в трекере правило: любой ответ, кроме 2xx, пишется в журнал вместе с полем code. Раз в день просматривайте частоту ошибок: резкий рост одного кода сразу показывает, что сломалось.

Связанные понятия

Читайте вместе с таймаутом, повтором доставки и идемпотентностью. Полная таблица кодов Лидпульта — на странице API.

Вопросы и ответы

Почему при ошибке 4xx не стоит повторять запрос?

Причина в самих данных или условиях оффера, поэтому тот же запрос вернёт тот же ответ. Сначала исправьте причину.

Что значит 5xx?

Сбой на стороне сервера. Запрос можно повторить позже с тем же apiid.