Перейти к основному содержанию
PATCH
cURL
Используйте этот endpoint, чтобы каждое приложение соответствовало клиенту, бренду, среде или внутреннему сценарию использования, который оно представляет. Для реселлеров это позволяет переименовывать или обновлять приложение каждого клиента без передачи учётных данных между клиентами. Для прямых клиентов это помогает разделять продукты, регионы или среды, сохраняя всё в рамках одной организации.
Этот endpoint обновляет метаданные приложения. api_key остаётся прежним, если вы не выполните ротацию учётных данных отдельно.

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

Расположение данных приложения (data_location) выбирается при его создании и не может быть изменено после этого: обновление, которое указывает уже имеющееся у приложения расположение, принимается, а любое другое расположение возвращает ответ 400. Исключение: продакшн-приложение, созданное вместе с вашей организацией при регистрации или через Проверка электронной почты. Первое обновление, в котором указано data_location, выбирает расположение один раз, при условии что ни один из API-ключей приложения не использовался и у приложения нет сессии верификации. Шаг консоли Назовите первое приложение использует это, чтобы сохранить выбранное там расположение. На данный момент единственное доступное расположение: eu, Европейский союз (Ирландия).

Авторизации

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 организации, владеющей приложением.

Пример:

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

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

UUID обновляемого приложения.

Пример:

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

Тело

application/json

Отправляйте только те поля, которые хотите изменить. Семантика PATCH: неуказанные поля сохраняются.

Тело запроса PATCH для метаданных приложения. Передавайте только те поля, которые хотите изменить; пропущенные поля сохраняются. Поля uuid, client_id и api_key нельзя обновить. Поле products доступно только для чтения: ключ products в теле запроса игнорируется. Поле data_location нельзя изменить после создания приложения: указание уже заданного расположения принимается, а любое другое вернёт 400. Единственным исключением является продакшн-приложение, созданное вместе с вашей организацией: первое обновление, задающее data_location, однократно выбирает его при условии, что ни один API-ключ приложения ещё не использовался и у него нет сессий верификации.

name
string

Отображаемое имя приложения.

Пример:

"Acme Production App"

website_url
string

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

Пример:

"https://app.acme.example"

redirect_uris
string[]

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

Пример:
terms_url
string

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

privacy_url
string

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

description
string

Внутреннее описание приложения.

data_location
enum<string>

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

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

"eu"

Ответ

Приложение обновлено. Ответ содержит полную запись приложения после изменения, включая products; значения uuid, client_id и api_key остаются без изменений.

Полная запись приложения. 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 г.