Ключ API - в «Разработчикам», «API-ключи»; ID воркфлоу - на странице «Рабочие процессы»; секрет подписи вебхука у каждой конечной точки в «Вебхуки».
Из консоли нужны три значения. Ключ API создаётся в Разработчикам → API-ключи. ID воркфлоу копируется на странице Рабочие процессы. Секрет подписи вебхука принадлежит каждой конечной точке в Разработчикам → Вебхуки, и его можно показать снова в любой момент кнопкой Показать. Берите все три из одного приложения и одной среды, Live или Sandbox.
В стартовом приложении или проекте, созданном ИИ, часто перечислены переменные окружения вроде DIDIT_API_KEY, DIDIT_WORKFLOW_ID и DIDIT_WEBHOOK_SECRET. Эти имена принадлежат самому приложению: Didit их за вас не задаёт. Эта таблица показывает, откуда берётся каждое значение.
#Где находится каждое значение
| Значение | Где взять | Что нужно знать |
|---|---|---|
| Ключ API | Разработчикам → API-ключи, затем Создать ключ (у каждого приложения также есть Основной ключ) | Полный секрет показывается один раз, при создании или ротации ключа, поэтому скопируйте его в менеджер секретов сразу. У приложения Live и приложения Sandbox разные ключи: ключ песочницы никогда не создаёт боевую верификацию. Передавайте его в заголовке x-api-key, только с вашего сервера |
| ID воркфлоу | Проверка личности → Процессы: откройте меню строки и выберите Скопировать ID рабочего процесса (в панели предпросмотра есть такая же кнопка) | У каждого воркфлоу в каждом приложении свой ID. У копии воркфлоу новый ID |
| Секрет подписи вебхука | Разработчикам → Вебхуки, откройте конечную точку, затем её секрет подписи и нажмите Показать | Один секрет на конечную точку, а не на приложение. Показ просит подтвердить, что это вы, после чего секрет снова скрывается в течение 60 секунд. Показать его снова можно, когда понадобится |
| Базовый URL API | Не в консоли: его указывает docs.didit.me | https://verification.didit.me обслуживает API верификации (сессии, воркфлоу, списки, вебхуки) с аутентификацией по заголовку x-api-key. См. аутентификацию API |
Ключ API и секрет подписи - это разные значения. Ключ API аутентифицирует ваши вызовы к Didit; секрет подписи позволяет проверить, что вебхук действительно пришёл от Didit. Если использовать одно вместо другого, будет 401 или несовпадение подписи.
#Можно ли снова увидеть секрет подписи вебхука?
Да. Откройте Разработчикам → Вебхуки, откройте конечную точку и нажмите Показать. Подтвердите, что это вы, и секрет будет виден до 60 секунд. Если Показать недоступна, попросите коллегу с доступом или свяжитесь с поддержкой. Если нужен новый секрет, лучше выполните ротацию: старый продолжит работать 24 часа. Подробнее в получении результатов верификации через вебхуки.
#Проверьте настройку
- Совместите среду
Сначала выберите в консоли приложение и среду Live или Sandbox, затем скопируйте там ключ и ID воркфлоу и создайте конечную точку вебхука. Ключ песочницы с боевым ID воркфлоу - частая причина ошибки 401 или 403.
- Поместите значения в конфигурацию сервера
Храните их как серверные секреты. Никогда не помещайте ключ API или секрет подписи в код фронтенда, публичный репозиторий или мобильное приложение.
- Создайте сессию
Вызовите эндпоинт создания сессии по адресу
https://verification.didit.meсо своим ключом и ID воркфлоу. Ошибка 401 означает, что ключ неверный, просрочен или отозван; 403 на воркфлоу обычно означает, что ключ принадлежит другому приложению. См. ошибки API. - Отправьте тестовое событие
В Разработчикам → Вебхуки откройте свою конечную точку и нажмите Отправить тестовое событие. Ваш сервер должен проверить подпись секретом подписи и ответить кодом 2xx. Если ничего не приходит, см. когда вебхук не приходит.
#Связанные материалы
- Управление ключами API
- Получение результатов верификации через вебхуки
- Построение воркфлоу для верификации
- Аутентификация API на docs.didit.me
Не нашли ответ? Поговорите с человеком.
Укажите ID организации и ID сессии, о которой спрашиваете.