# Где найти ключ API, ID воркфлоу и секрет вебхука?

Source: https://help.didit.me/ru/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

Ключ 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](https://docs.didit.me/getting-started/api-authentication) |

> **Note:** Ключ API и секрет подписи - это разные значения. Ключ API аутентифицирует
> ваши вызовы к Didit; секрет подписи позволяет проверить, что вебхук
> действительно пришёл от Didit. Если использовать одно вместо другого, будет 401 или несовпадение подписи.

## Можно ли снова увидеть секрет подписи вебхука?

Да. Откройте **Разработчикам → Вебхуки**, откройте конечную точку и нажмите **Показать**. Подтвердите, что это вы, и секрет будет виден до 60 секунд. Если **Показать** недоступна, попросите коллегу с доступом или [свяжитесь с поддержкой](https://help.didit.me/ru/getting-started/contacting-didit-support). Если нужен новый секрет, лучше выполните ротацию: старый продолжит работать 24 часа. Подробнее в [получении результатов верификации через вебхуки](https://help.didit.me/ru/integration/webhooks-basics).

## Проверьте настройку

1. **Совместите среду**

   Сначала выберите в консоли приложение и среду **Live** или **Sandbox**, затем скопируйте там ключ и ID воркфлоу и создайте конечную точку вебхука. Ключ песочницы с боевым ID воркфлоу - частая причина ошибки 401 или 403.

2. **Поместите значения в конфигурацию сервера**

   Храните их как серверные секреты. Никогда не помещайте ключ API или секрет подписи в код фронтенда, публичный репозиторий или мобильное приложение.

3. **Создайте сессию**

   Вызовите эндпоинт создания сессии по адресу `https://verification.didit.me` со своим ключом и ID воркфлоу. Ошибка 401 означает, что ключ неверный, просрочен или отозван; 403 на воркфлоу обычно означает, что ключ принадлежит другому приложению. См. [ошибки API](https://help.didit.me/ru/integration/api-errors).

4. **Отправьте тестовое событие**

   В **Разработчикам → Вебхуки** откройте свою конечную точку и нажмите **Отправить тестовое событие**. Ваш сервер должен проверить подпись секретом подписи и ответить кодом 2xx. Если ничего не приходит, см. [когда вебхук не приходит](https://help.didit.me/ru/integration/webhook-troubleshooting).

## Связанные материалы

- [Управление ключами API](https://help.didit.me/ru/account-organization/api-keys)
- [Получение результатов верификации через вебхуки](https://help.didit.me/ru/integration/webhooks-basics)
- [Построение воркфлоу для верификации](https://help.didit.me/ru/workflows/build-a-verification-workflow)
- [Аутентификация API](https://docs.didit.me/getting-started/api-authentication) на docs.didit.me