Многоразовые ссылки для верификации

Одна долгоживущая ссылка на воркфлоу, которая запускает новую сессию при каждом переходе - подходит для кнопки на сайте, QR-кода или партнёров. Добавьте собственный идентификатор через vendor_data.

Short answer

У каждого воркфлоу есть одна многоразовая ссылка, которая создаёт новую сессию для каждого посетителя. Разместите её за кнопкой, распечатайте как QR-код или передайте партнёрам. Добавьте собственный идентификатор через ?vendor_data=, чтобы понимать, чья это сессия.

#Одна ссылка, много людей

Разовая ссылка для верификации принадлежит одному человеку. Многоразовая ссылка принадлежит воркфлоу: каждый переход по ней запускает новую сессию, поэтому вы можете опубликовать один URL и дать любому количеству людей пройти верификацию через него.

Список воркфлоу в консоли Didit с действием Copy link в строке воркфлоу
  1. Copy link даёт URL, который может открыть кто угодно - без вызова API.
  2. Ссылка запускает то, что содержит этот воркфлоу, поэтому сначала проверьте его функции.
  3. Отдельный воркфлоу даёт отдельную ссылку - так вы отличаете кампании друг от друга.
Многоразовая ссылка доступна одним действием из любого воркфлоу.

Хорошо подходит для:

  • Кнопки "Подтвердите личность" на вашем сайте
  • Распечатанного QR-кода в филиале, на киоске или мероприятии
  • Ссылки, переданной партнёрам, аффилиатам или реселлерам
  • Любой ситуации, когда заранее неизвестно, кто ей воспользуется

#Как отличить сессии друг от друга

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

https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID

Всё, что вы передадите как vendor_data, вернётся вместе с сессией и в каждом webhook, поэтому вы сможете сопоставить результат с нужной записью на своей стороне без отдельной таблицы соответствий.

Tip

Генерируйте значение для каждого пользователя отдельно - это может быть ваш собственный ID пользователя или подписанный токен, который вы умеете разрешать. Это также заставит правильно работать обнаружение дублей: сессии с одинаковым vendor_data объединяются в одного консолидированного пользователя, поэтому вернувшийся клиент не будет помечен как дубликат самого себя. См. дублирующиеся аккаунты и поиск по лицу.

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

#Чего многоразовая ссылка не даёт

  • Нет индивидуального срока действия. Разовая ссылка на сессию может истечь по времени; многоразовая ссылка задумана как постоянно активная. Если вам нужна ссылка, которая истекает для конкретного человека, создайте отдельную сессию.
  • Нет предзаполненных ожидаемых данных. Когда вы создаёте сессию через API, можно передать имя или номер документа для сверки. У общей ссылки нет контекста по конкретному человеку, поэтому такие сверки недоступны.
  • Нет контроля над тем, кто ею пользуется. Многоразовая ссылка - это публичный URL. Начать сессию по ней может кто угодно, что нормально для кнопки на сайте, но не очень подходит, если ссылка предназначалась только одному человеку.

#Стоимость остаётся такой же, как у воркфлоу

Каждый переход по многоразовой ссылке - это полноценная сессия по этому воркфлоу, оплачиваемая так же, как и любая другая. Ссылка, разошедшаяся шире, чем вы ожидали, означает счёт больше, чем вы ожидали, поэтому если вы публикуете ссылку где-то в открытом доступе, следите за объёмом в разделе "Аналитика". См. чтение аналитики.

#Какой воркфлоу она использует

Ссылка привязана к конкретному воркфлоу в конкретном приложении, поэтому она всегда запускает текущую опубликованную версию этого воркфлоу. Изменение воркфлоу меняет то, что получают новые посетители - уже начатые сессии сохраняют версию, с которой они стартовали.

#Получение результатов

Так же, как и везде: следите за консолью или получайте результаты через webhook. Поскольку сессии здесь появляются непредсказуемо, а не в ответ на ваши собственные вызовы API, webhook здесь заметно полезнее опроса - опрашивать попросту нечего, пока сессия не создана.

#Полная документация

См. ссылки для верификации и многоразовые ссылки для подробного описания в консоли.