Перейти к основному содержанию
PATCH
curl
Предварительно подписанные ссылки в extra_files истекают. Если файлы понадобятся позже, получите новые ссылки из решения по сессии. Чтобы исправить данные, извлечённые из документа, используйте Обновление данных сессии.

Авторизации

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 сессии Проверки пользователей (KYC), в которую добавляется файл (session_id, возвращаемый методом POST /v3/session/). Идентификатор сессии Верификации бизнеса (KYB) вернёт 404.

Пример:

"11111111-2222-3333-4444-555555555555"

Тело

multipart/form-data
file
file
обязательно

Изображение или PDF. Допустимые расширения: jpg, jpeg, png, webp, tiff, pdf. Не более 15 MB при загрузке; затем файл сжимается и отклоняется с кодом 400, если он всё ещё превышает 2 MB (2,097,152 байт). Пустые файлы отклоняются.

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

kyc добавляет файл к результату верификации личности, а poa к результату подтверждения адреса.

Доступные опции:
kyc,
poa
Пример:

"kyc"

file_password
string

Пароль от зашифрованного PDF-файла. Без него или при неверном пароле зашифрованный PDF возвращает 400.

Ответ

Файл добавлен. Возвращает все дополнительные файлы этого результата, включая новый.

extra_files
(string<uri> | null)[]
обязательно

Временные предварительно подписанные ссылки на все дополнительные файлы результата, определённого параметром model_type, от старых к новым. Каждая ссылка имеет значение null для API-ключа с ограниченной областью действия без права media: read. Свежие ссылки можно прочитать позже из решения по сессии.

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