Перейти к основному содержанию
POST
curl
Подготовьте один ZIP-архив со всеми файлами сессии «Проверка пользователей» (KYC) или Верификация бизнеса (KYB): стороны документа, селфи, видео проверки живости и загруженные документы в исходном качестве. ZIP-архив готовится в фоновом режиме. Запрос возвращает 202 с экспортом; проверяйте его с помощью Получить экспорт файлов, пока status не станет READY, затем скачайте download_url.
  • Пока экспорт той же сессии еще готовится, запрос возвращает этот экспорт вместо запуска нового.
  • ZIP-архив удаляется через 24 часа после готовности, а также сразу при удалении сессии.
  • Удаленную сессию нельзя экспортировать: запрос возвращает 404.
  • Каждый экспорт записывается в журнал аудита сессии.
  • API-ключу с ограниченной областью действия требуются media: read и decisions: read.

Авторизации

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). Для удалённой сессии возвращается 404.

Пример:

"11111111-2222-3333-4444-555555555555"

Ответ

Экспорт подготавливается.

Один ZIP-архив со всеми файлами сессии в исходном качестве.

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

ID экспорта. Передайте его в GET /v3/session/{sessionId}/files-export/{exportId}/.

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

Сессия, из которой получены файлы.

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

PENDING и PROCESSING во время подготовки ZIP-архива, READY, как только его можно скачать, FAILED, если не удалось подготовить (запросите новый экспорт), EXPIRED после удаления ZIP-архива.

Доступные опции:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
обязательно

Файлы в архиве ZIP. Задаётся только пока status равен READY.

size_bytes
integer<int64> | null
обязательно

Размер ZIP-архива в байтах. Заполняется только пока status равен READY.

download_url
string<uri> | null
обязательно

Подписанный URL-адрес ZIP-архива, действующий в течение короткого времени. Заполняется только пока status равен READY; для получения нового запросите экспорт повторно.

expires_at
string<date-time> | null
обязательно

Когда ZIP-архив удаляется, через 24 часа после готовности. Задаётся только пока status имеет значение READY.

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

Причина сбоя экспорта, если status имеет значение FAILED.

created_at
string<date-time>
обязательно

Когда был запрошен экспорт.

completed_at
string<date-time> | null
обязательно

Когда ZIP-архив был готов или экспорт завершился ошибкой.

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