Таймаут: что это
Таймаут — предел времени, который программа готова ждать ответа. Если сервер не ответил вовремя, запрос считается неудачным, даже если на другой стороне он мог дойти и выполниться.
Определение
Без таймаута программа могла бы ждать вечно, и зависшее соединение блокировало бы работу. Поэтому для каждого сетевого запроса задаётся предел: например, несколько секунд на соединение и несколько на получение ответа.
Пример из лидогенерации
Ваш сервер отправил лид и не получил ответ за отведённое время. Что произошло: заявка не дошла или дошла, но ответ потерялся? Вы этого не знаете. Безопасное решение — повторить запрос с тем же apiid: если лид уже принят, вернётся прежний lead_id, а дубль не появится.
Как выбирать значение
- Слишком короткий таймаут даёт ложные «сбои» при медленной сети.
- Слишком длинный держит пользователя у формы в ожидании.
- Для формы на сайте разумно отвечать посетителю сразу, а отправку в сеть выполнять в фоне.
Таймауты на стороне сети
Лидпульт тоже ограничивает время ожидания, когда сам обращается наружу: отправляет постбэки и вебхуки только на публичные адреса, без редиректов и с таймаутом. Если ваш приёмник отвечает слишком медленно, отправка считается неудачной и будет повторена.
Нюансы
Таймаут не равен отказу сервера. Без идентификатора идемпотентности повтор после таймаута может создать дубль, а при исчерпании повторов заявка может остаться не принятой. Всегда пишите в журнал факт истечения.
Практический совет
Для формы на сайте разумная схема такая: ответить посетителю сразу, а отправку в сеть выполнить в фоне с повторами. Тогда долгий ответ внешнего сервера не испортит впечатление и не потеряет заявку.
Связанные понятия
Тема соседствует с HTTP-кодом ответа, повтором доставки и очередью сообщений. Правила повторов описаны в документации API.
Вопросы и ответы
Какой таймаут ставить при отправке лида?
Выбирайте значение с запасом на медленную сеть и всегда повторяйте запрос с одним apiid.
Теряется ли заявка при таймауте?
Не обязательно: она могла быть принята. Поэтому повтор с apiid безопасен.