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

- Copy link даёт URL, который может открыть кто угодно - без вызова API.
- Ссылка запускает то, что содержит этот воркфлоу, поэтому сначала проверьте его функции.
- Отдельный воркфлоу даёт отдельную ссылку - так вы отличаете кампании друг от друга.
Хорошо подходит для:
- Кнопки "Подтвердите личность" на вашем сайте
- Распечатанного QR-кода в филиале, на киоске или мероприятии
- Ссылки, переданной партнёрам, аффилиатам или реселлерам
- Любой ситуации, когда заранее неизвестно, кто ей воспользуется
#Как отличить сессии друг от друга
Очевидная проблема одной общей ссылки в том, что каждая полученная через неё сессия выглядит анонимной. Решается это добавлением собственного идентификатора:
https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID
Всё, что вы передадите как vendor_data, вернётся вместе с сессией и в каждом webhook, поэтому вы сможете сопоставить результат с нужной записью на своей стороне без отдельной таблицы соответствий.
Генерируйте значение для каждого пользователя отдельно - это может быть ваш
собственный ID пользователя или подписанный токен, который вы умеете
разрешать. Это также заставит правильно работать обнаружение дублей: сессии с
одинаковым vendor_data объединяются в одного консолидированного
пользователя, поэтому вернувшийся клиент не будет помечен как дубликат самого
себя. См.
дублирующиеся аккаунты и поиск по лицу.
Если вы генерируете значение динамически для каждого посетителя, формируйте всю ссылку на сервере. vendor_data, которое пользователь может отредактировать в адресной строке, - это vendor_data, в которое пользователь может вписать чужой ID.
#Чего многоразовая ссылка не даёт
- Нет индивидуального срока действия. Разовая ссылка на сессию может истечь по времени; многоразовая ссылка задумана как постоянно активная. Если вам нужна ссылка, которая истекает для конкретного человека, создайте отдельную сессию.
- Нет предзаполненных ожидаемых данных. Когда вы создаёте сессию через API, можно передать имя или номер документа для сверки. У общей ссылки нет контекста по конкретному человеку, поэтому такие сверки недоступны.
- Нет контроля над тем, кто ею пользуется. Многоразовая ссылка - это публичный URL. Начать сессию по ней может кто угодно, что нормально для кнопки на сайте, но не очень подходит, если ссылка предназначалась только одному человеку.
#Стоимость остаётся такой же, как у воркфлоу
Каждый переход по многоразовой ссылке - это полноценная сессия по этому воркфлоу, оплачиваемая так же, как и любая другая. Ссылка, разошедшаяся шире, чем вы ожидали, означает счёт больше, чем вы ожидали, поэтому если вы публикуете ссылку где-то в открытом доступе, следите за объёмом в разделе "Аналитика". См. чтение аналитики.
#Какой воркфлоу она использует
Ссылка привязана к конкретному воркфлоу в конкретном приложении, поэтому она всегда запускает текущую опубликованную версию этого воркфлоу. Изменение воркфлоу меняет то, что получают новые посетители - уже начатые сессии сохраняют версию, с которой они стартовали.
#Получение результатов
Так же, как и везде: следите за консолью или получайте результаты через webhook. Поскольку сессии здесь появляются непредсказуемо, а не в ответ на ваши собственные вызовы API, webhook здесь заметно полезнее опроса - опрашивать попросту нечего, пока сессия не создана.
#Полная документация
См. ссылки для верификации и многоразовые ссылки для подробного описания в консоли.
