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