Перейти к основному содержанию
POST
Python

Авторизации

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 сессии Верификации бизнеса (KYB). Он должен принадлежать приложению используемого API-ключа.

Пример:

"33333333-4444-5555-6666-777777777777"

Параметры запроса

node_id
string

Узел сценария для шага KYB. Требуется, только если в сценарии несколько KYB-узлов; по умолчанию Didit использует собственный узел сессии.

Тело

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

Файлы для загрузки: JPG, JPEG, PNG, TIFF, WEBP, PDF или ZIP-архивы с ними. Файлы PDF до 50 МБ, фотографии до 6 МБ до сжатия.

document_passwords
string[]

Одна запись на каждый файл в documents в том же порядке: пароль для защищённого PDF, пусто для любого другого файла.

document_group
enum<string>

Обязательная группа документов, которую покрывает эта загрузка.

Доступные опции:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Локаль, используемая для перевода ответа следующего шага.

Maximum string length: 10

Ответ

Обработанные документы. Когда требования для каждой обязательной группы выполнены, сессия переходит на следующий шаг, и next_step указывает имя следующего шага; в противном случае она остаётся на шаге «Документы», а document_groups и document_answer указывают, чего именно не хватает.

valid
boolean
next_step
string | null

Шаг, на котором находится сессия после загрузки.

kyb_status
string

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

document_answer
object

Результат по каждому загруженному документу и оставшиеся загрузки.

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