Перейти к основному содержанию
POST
cURL
Используйте этот эндпоинт, когда нужно разделить трафик верификации, учётные данные, брендинг или отчётность внутри одной организации. Это особенно полезно для перепродавцов, которые создают отдельное приложение для каждого клиента. Оно также хорошо подходит, если у вашей компании несколько продуктов, брендов, регионов, тестовых/продакшн-сред или сценариев использования, которые не должны использовать общий API-ключ и общие настройки на уровне приложения.
Все эндпоинты Auth API используют https://apx.didit.me/auth/v2. Используйте возвращённый api_key как x-api-key при вызове эндпоинтов https://verification.didit.me/v3/..., например для сессий и сценариев.

Местоположение данных

Каждое приложение хранит и обрабатывает данные верификации в одном месте, в своём местоположении данных, которое выбирается при создании через параметр data_location. Сейчас доступно только одно местоположение: eu, Европейский союз (Ирландия). Оно также используется по умолчанию, если поле не указано. Австралия (Сидней, au) и Мексика (mx) скоро появятся: запрос с их указанием вернёт 400 This data location is not available yet. и ничего не создаст. Любой запрос на получение приложения возвращает его data_location, и после создания приложения это значение изменить нельзя. См. Местоположение данных.

Авторизации

Authorization
string
header
обязательно

Подписанный по алгоритму RS256 JWT access_token, возвращаемый вызовами POST /programmatic/login/ или POST /programmatic/verify-email/. Передавайте как Authorization: Bearer <access_token>. Срок действия по умолчанию составляет 86400 секунд (24 часа). Этот token действителен только для endpoints управления аккаунтом на apx.didit.me/auth/v2. API верификации (verification.didit.me/v3) использует вместо него долгоживущий api_key в заголовке x-api-key.

Параметры пути

org_id
string<uuid>
обязательно

UUID организации. Его можно узнать с помощью GET /organizations/me/.

Пример:

"a1b2c3d4-5678-90ab-cdef-111111111111"

Тело

application/json

Все поля необязательны. Если тело запроса не указано, создается приложение с именем по умолчанию "<organization name> App" и без настроенных публичных URL.

Все поля необязательны. Отправка пустого тела запроса создает приложение с именем по умолчанию в Европейском союзе.

name
string

Отображаемое имя приложения. По умолчанию: "<organization name> App".

Пример:

"Acme Customer App"

website_url
string

URL веб-сайта или приложения, связанный с этим приложением.

Пример:

"https://acme.example"

redirect_uris
string[]

Разрешённые URI перенаправления для потоков перенаправления OAuth и верификации.

Пример:
terms_url
string

URL условий использования, отображаемый в процессе верификации.

Пример:

"https://acme.example/terms"

privacy_url
string

URL политики конфиденциальности, отображаемый в процессе верификации.

Пример:

"https://acme.example/privacy"

description
string

Внутреннее описание приложения (не отображается конечным пользователям).

data_location
enum<string>

Место хранения и обработки данных верификации приложения выбирается при создании приложения. eu: Европейский союз (Ирландия), по умолчанию. au (Австралия, Сидней) и mx (Мексика) станут доступны в ближайшее время: запрос с их указанием возвращает 400 This data location is not available yet. Приложение песочницы организации всегда располагается в Европейском союзе.

Доступные опции:
eu,
au,
mx
Пример:

"eu"

Ответ

Приложение создано. Ответ содержит долгоживущий api_key; сохраните его сейчас и используйте в заголовке x-api-key при каждом вызове https://verification.didit.me/v3/....

Полная запись приложения. uuid, client_id и api_key никогда не меняются после создания. data_location также не меняется, за исключением одного раза для продакшн-приложения, созданного вместе с вашей организацией, до начала его использования (см. запрос на обновление).

uuid
string<uuid>

UUID приложения. Используйте как {app_id} в последующих вызовах.

Пример:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Отображаемое имя приложения, показываемое в консоли Didit.

Пример:

"Acme Production App"

client_id
string

Публичный идентификатор клиента, безопасный для встраивания в сценарии авторизации наподобие OAuth.

Пример:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Долгоживущий секрет (также называемый client_secret). Используйте в качестве заголовка x-api-key для каждого вызова к https://verification.didit.me/v3/... (сессии, сценарии, AML и т. д.). Относитесь к нему как к конфиденциальным данным; никогда не раскрывайте на стороне клиента. Новые ключи начинаются с sk_live_ (продакшн-приложение) или sk_test_ (приложение в песочнице), за которыми следуют 43 URL-безопасных символа (буквы, цифры, - и _). Ключи, созданные до ввода этого формата, не имеют префикса и продолжают работать без изменений. В течение 72 часов после восстановления аккаунта запросы на получение списка, просмотр и обновление возвращают здесь пустую строку вместо ключа.

Пример:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL веб-сайта или приложения, связанный с этим приложением.

Пример:

"https://acme.example"

redirect_uris
string[]

Разрешённые URI перенаправления для потоков перенаправления OAuth и верификации.

Пример:
terms_url
string | null

URL условий использования, отображаемый в процессе верификации.

Пример:

"https://acme.example/terms"

privacy_url
string | null

URL политики конфиденциальности, отображаемый в процессе верификации.

Пример:

"https://acme.example/privacy"

description
string | null

Внутреннее описание приложения (не отображается конечным пользователям).

created_at
string<date-time>
Пример:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Место хранения и обработки данных верификации приложения выбирается при создании приложения. eu: Европейский союз (Ирландия), по умолчанию. au (Австралия, Сидней) и mx (Мексика) станут доступны в ближайшее время: запрос с их указанием возвращает 400 This data location is not available yet. Приложение песочницы организации всегда располагается в Европейском союзе.

Доступные опции:
eu,
au,
mx
Пример:

"eu"

products
object[]
read-only

Продукты приложения. Всегда все три в следующем порядке: identity, transactions, authentication. В новом приложении включён продукт identity со всеми активными модулями, а transactions и authentication отключены. Только для чтения: ключ products в теле создания или обновления игнорируется.

Пример:
Последнее изменение 7 ноября 2026 г.