Лидпульт

Таймаут: что это

Таймаут — предел времени, который программа готова ждать ответа. Если сервер не ответил вовремя, запрос считается неудачным, даже если на другой стороне он мог дойти и выполниться.

Определение

Без таймаута программа могла бы ждать вечно, и зависшее соединение блокировало бы работу. Поэтому для каждого сетевого запроса задаётся предел: например, несколько секунд на соединение и несколько на получение ответа.

Пример из лидогенерации

Ваш сервер отправил лид и не получил ответ за отведённое время. Что произошло: заявка не дошла или дошла, но ответ потерялся? Вы этого не знаете. Безопасное решение — повторить запрос с тем же apiid: если лид уже принят, вернётся прежний lead_id, а дубль не появится.

Как выбирать значение

  • Слишком короткий таймаут даёт ложные «сбои» при медленной сети.
  • Слишком длинный держит пользователя у формы в ожидании.
  • Для формы на сайте разумно отвечать посетителю сразу, а отправку в сеть выполнять в фоне.

Таймауты на стороне сети

Лидпульт тоже ограничивает время ожидания, когда сам обращается наружу: отправляет постбэки и вебхуки только на публичные адреса, без редиректов и с таймаутом. Если ваш приёмник отвечает слишком медленно, отправка считается неудачной и будет повторена.

Нюансы

Таймаут не равен отказу сервера. Без идентификатора идемпотентности повтор после таймаута может создать дубль, а при исчерпании повторов заявка может остаться не принятой. Всегда пишите в журнал факт истечения.

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

Для формы на сайте разумная схема такая: ответить посетителю сразу, а отправку в сеть выполнить в фоне с повторами. Тогда долгий ответ внешнего сервера не испортит впечатление и не потеряет заявку.

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

Тема соседствует с HTTP-кодом ответа, повтором доставки и очередью сообщений. Правила повторов описаны в документации API.

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

Какой таймаут ставить при отправке лида?

Выбирайте значение с запасом на медленную сеть и всегда повторяйте запрос с одним apiid.

Теряется ли заявка при таймауте?

Не обязательно: она могла быть принята. Поэтому повтор с apiid безопасен.