Лидпульт

Идемпотентность: что это

Идемпотентная операция при повторе даёт тот же результат, что и при первом выполнении. Для лидогенерации это защита от ситуации, когда из-за сбоя сети одна заявка превращается в две.

Определение

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

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

Трекер отправил лид, но ответ потерялся из-за сети. Он не знает, принята заявка или нет, и повторяет запрос. Если вместе с запросом передан apiid, Лидпульт вернёт прежний lead_id и пометку duplicate_of_request: true, а новая заявка не создастся и не будет оплачена дважды.

Нюансы

  • Идентификатор должен быть уникален для каждой заявки и одинаков при повторах. Случайное значение на каждый запрос не защитит.
  • Не путайте с проверкой дубля по телефону: она работает отдельно, в окне 30 дней по офферу.
  • Идемпотентность не решает ситуацию, когда один человек оставил две заявки с разными apiid: это уже дубль по телефону.

Как внедрить у себя

Присваивайте заявке идентификатор в момент создания на вашей стороне, например номер из вашей базы, и передавайте его во всех попытках отправки. Повторяйте запрос только при ошибке сети и ответах 5xx.

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

Проверьте работу защиты тестом: отправьте один и тот же тестовый запрос дважды с одинаковым идентификатором и убедитесь, что оба ответа содержат одинаковый номер заявки. Так вы увидите, что повторы безопасны, ещё до запуска трафика.

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

Практическое воплощение — параметр apiid. Тесно связаны повтор доставки, HTTP-код ответа и таймаут. Правила приёма смотрите в API.

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

Нужно ли передавать apiid всегда?

Параметр необязателен, но мы рекомендуем передавать его всегда, особенно через трекеры с повторными попытками.

Что будет, если отправить тот же apiid с другим телефоном?

Идентификатор указывает на уже принятую заявку, поэтому используйте для каждой заявки новое значение.