Перейти к основному содержанию
PATCH
curl
Ключи полей соответствуют тем, которые вы задали для документа в сценарии. О том, как настраиваются документы и поля, см. в разделе Document AI, а о том, где результат появляется в решении по сессии, см. в разделе отчёт Document AI.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

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

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

UUID сессии верификации (session_id, возвращённый POST /v3/session/). Принимает ID сессий как Проверки пользователей (KYC), так и Верификации бизнеса (KYB): сервер сопоставляет ID для обоих типов сессий. Должен быть корректным UUID; некорректное значение не соответствует маршруту и возвращает HTML 404.

Пример:

"11111111-2222-3333-4444-555555555555"

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

UUID документа Document AI (document_ai_documents[].items[].uuid в GET /v3/session/{sessionId}/decision/). Он должен принадлежать сессии, указанной в пути.

Пример:

"44444444-5555-6666-7777-888888888888"

Тело

application/json
extracted_data
object

Ключи полей (ключи, которые вы настроили для документа) и их исправленные значения. Должно быть объектом JSON; объединяется по ключам с сохранёнными данными. Лучше опустить поле, чем передавать null, что приведёт к ошибке 400.

Пример:
status
enum<string>

Новый статус проверки документа.

Доступные опции:
Approved,
Declined,
In Review,
Not Finished
Пример:

"Approved"

Ответ

Документ обновлён. Возвращает документ после объединения.

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

Идентификатор документа.

document_key
string
обязательно

Настроенный документ, которому соответствует эта загрузка.

original_filename
string | null
обязательно

Имя файла, с которым был загружен документ.

file_url
string | null
обязательно

Путь хранения загруженного файла. Это не ссылка на скачивание: чтобы скачать файл, прочитайте предварительно подписанный file_url из решения по сессии.

status
enum<string>
обязательно

Статус проверки документа.

Доступные опции:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
обязательно

Все извлечённые поля после объединения, с ключами, соответствующими ключам полей.

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