Интеграция Didit: API, SDK и webhook

Полная расшифровка Интеграция Didit в ваше приложение: API, SDK и webhook (руководство для разработчиков): восьмое из десяти видео Didit Academy, 08:13. Смотреть на YouTube. Каждый абзац ведёт к точному моменту в видео.

​

Что вы подключите

00:04 В этом видео вы подключите Didit к своему приложению. Пользователи будут проходить верификацию прямо внутри вашего продукта, а каждый результат будет поступать в вашу систему в момент его получения. Это видео для разработчиков, поэтому оно немного техничнее, но проще, чем кажется. К концу вы увидите, что большую часть работы можно передать Cloud Code, и он всё соберёт за вас. Итак, мы пройдём всё в том порядке, в котором вы бы это реально создавали

​

SDK, API и webhook: три компонента

00:28 Давайте начнём. Интеграция Didit означает настройку трёх компонентов. SDK отображает камеру, захват документа, чтение NFC и UI проверки живости прямо внутри вашего приложения. API работает по схеме сервер-сервер: ваш бэкенд создаёт сессию и получает официальное решение. А webhook вызывает ваш HTTPS-endpoint в момент изменения состояния сессии, что намного

​

Вкладка Integrate

00:56 быстрее и информативнее, чем поллинг. Проще всего интегрироваться через вкладку Manage: откройте Integrate, и все настройки можно взять оттуда. Так можно взять свой API-ключ. Можно создать отдельный API-ключ именно для того приложения, над которым вы работаете. Можно создать и выбрать сценарий, который хотите интегрировать. Можно добавить webhook. Именно сюда отправляются результаты верификации. 01:24 Секрет для подписи, который я покажу через секунду, это как раз то, что нужно

​

Выбор платформы

01:28 положить в ваш файл ENV. Затем его можно подключить к приложению. Здесь доступно несколько вариантов: web JS, React Native, iOS, Android, Flutter и другие платформы. Выберите подходящий для вашего приложения. Это секреты окружения, которые нужно положить в файл ENV на вашем

​

Промпт для настройки с ИИ

01:48 сервере. Для настройки проще всего использовать промпт для настройки с ИИ. Все параметры задаются здесь, затем вы копируете промпт, и он содержит всю нужную информацию из выполненной настройки. Вставьте его в Cloud Code, Codex или в любой другой инструмент, с помощью которого вы создаёте приложение

​

API-ключи: по одному на каждую среду

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

​

Создание ключа

02:27 можете завести отдельный API-ключ именно для этого сценария, например. Если я нажму create API key, назову ключ test и создам его. Теперь его можно скопировать, но больше я его не увижу. Поэтому важно скопировать ключ и записать где-нибудь, чтобы использовать при интеграции. Когда вы переходите в раздел интеграции и берёте API-ключ, допустим, я беру тестовый ключ, затем выбираю сценарий KYC, который хочу использовать. Можно добавить webhook. 03:05 Затем подключаем наше приложение. Дальше вставляем сюда промпт для настройки. Видно, что этот промпт включает API-ключ

​

Обзор webhook

03:13 Возвращаясь к webhook: их можно настроить практически для любых событий. Например, если нужно отправлять определённое событие в Slack, можно

​

Документация

03:25 добавить URL webhook здесь. Теперь посмотрим документацию. Вся техническая документация доступна на docs.didit.me, и мы рассмотрим несколько разделов

​

Create session: единственное обязательное поле

03:37 в ней. Всё строится вокруг create session. Это POST-запрос, он запускает верификацию. В curl-запросе видно workflow ID. Это единственное обязательное поле, и действительно полезно то, что один и тот же endpoint создаёт и KYC-, и KYB-сессии. Сценарий

​

Vendor data и URL обратного вызова

04:00 определяет, какая из них какая. Есть и дополнительные поля, в том числе vendor data, о которых мы много говорили в этих видео. Это уникальный идентификатор каждого пользователя, и его можно задать как угодно: это может быть email или любой другой уникальный идентификатор. Затем есть URL обратного вызова. Сюда пользователь попадёт после того, как пройдёт сценарий верификации. Итак,

​

Пробуем endpoint в деле

04:24 если прокрутить страницу вниз, можно попробовать запрос прямо здесь. Нажмите try it, и можно создать сессию верификации. Вставлю один из API-ключей. Создам новый, назову его test two и скопирую. Вставлю его сюда. Нужен workflow ID, поэтому перейду сюда и возьму workflow ID. Введу его туда. Vendor data не требуются. Давайте просто введём случайный набор цифр. 05:02 Callback можно оставить как есть. Кстати, ничего из этого не обязательно. Думаю, это потому, что у меня тестовый аккаунт, но если вы хотите проверить этот endpoint, именно так и нужно его тестировать. Если вы разработчик и вам нужны точные ответы, посмотрите документацию. MCP тоже имеет доступ ко всей этой документации, поэтому можно просто подключить MCP и спросить Claude о любом техническом вопросе, который, скорее всего, есть в этих документах

​

Webhooks: почему не поллинг

05:32 Внутри этого раздела. Итак, поговорим о webhook. В разделе управления есть вкладка для webhook, и именно через неё к вам попадают результаты. Webhook рекомендуется как канал получения данных, потому что поллинг довольно медленный и

​

Добавление адреса назначения webhook и выбор событий

05:44 требует больше запросов и пропускает события. Итак, здесь мы добавляем новый адрес назначения webhook. Можно вставить URL. Можно выбрать нужные события. Это все данные, которые мы хотим отправлять на этот конкретный endpoint. Didit вернёт вам одноразовый секрет подписи, который я покажу через секунду. URL должен быть напрямую доступен: без localhost и частных IP-адресов. Итак, я выйду отсюда и прокручу вправо, там есть несколько вариантов. 06:16 Здесь видно, на какое количество событий подписан этот webhook, и можно

​

Секрет подписи

06:19 скопировать секрет подписи, он важен для вашей интеграции. Когда мы настраиваем интеграцию на вкладке интеграций, о которой я рассказывал, там есть промпт, и секрет подписи для выбранного в настройке webhook будет здесь. Итак,

​

Промпт для обработчика webhook

06:34 ещё один способ использовать ИИ: здесь есть готовый промпт, который я нашёл на вкладке webhook. Если хотите настроить обработчик webhook с помощью ИИ, можно открыть документацию и найти там промпт для интеграции. Он охватывает верификацию личности, сущностей и транзакций и создаёт всё целиком. Промпт описывает всё: что нужно создать, заголовки для проверки подписи, типы событий webhook, которые вы видели при настройке webhook, обёртку webhook и многое другое. Также можно выбрать, в какой инструмент его вставить. 07:15 Итак, если хотите использовать этот промпт, это самый простой способ начать и настроить интеграции. Всё, что я только что показал в этом видео, доступно и для запросов внутри вашего ИИ-инструмента, если вы подключите MCP-сервер. Вы можете просто описать простыми словами, что должно произойти, и Cloud Code прочитает документацию и создаст интеграцию за вас. Вам остаётся проверить результат и убедиться, что всё

​

Итоги

07:41 работает, а не писать всё с нуля. Итак, это Didit в вашем приложении: SDK, который видят ваши пользователи, API, который вызывает ваш бэкенд, и подписанный webhook, который передаёт решение, на которое вы опираетесь. Доверяйте webhook, используйте данные вендора везде и пользуйтесь промптом для настройки, чтобы не подключать вручную рутинные части. Перейдите на didit.me, зарегистрируйтесь бесплатно, и вы сможете запустить верификацию за несколько минут.