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

Обзор

Возвращает один PDF с полной историей верификаций сущности User, найденной по vendor_data. Это тот же документ, который Console формирует по пути User detail → Actions → Download PDF. Комплаенс-команды могут автоматизировать экспорт и не выгружать данные по каждому пользователю вручную. Отчёт содержит:
  • Титульную страницу со сводкой профиля (имя, дата рождения, страны выдачи, подтверждённые адреса электронной почты и телефоны), последним статусом каждой функции, счётчиками сессий и индексом включённых сессий.
  • Полный отчёт по каждой включённой сессии в хронологическом порядке (от самой старой к самой новой). Каждый такой отчёт совпадает с тем, что Генерация PDF возвращает для этой сессии отдельно.

Подходящие сессии и лимит

В отчёт включаются только сессии проверки пользователей (KYC) в статусах Approved, Declined, In Review или Kyc Expired. Сессии в любом другом статусе (Not Started, In Progress, Abandoned, Expired, …) пропускаются. Отчёт ограничен 20 самыми последними подходящими сессиями. Если у пользователя их больше, включаются 20 самых новых, а на титульной странице указано, сколько более старых сессий не вошло в отчёт. Если нужен полный список в формате JSON, используйте Список сессий с фильтром по vendor_data.

Ответ

Тело ответа — это сам PDF (application/pdf), а не JSON-обёртка и не ссылка для скачивания. Заголовок Content-Disposition имеет вид attachment; filename=user_<didit_internal_id>.pdf, где didit_internal_id — это стабильный идентификатор пользователя в Didit.

White label

Если для вашего приложения включена настройка White label, на титульной странице и в каждом отчёте по сессии вместо брендинга Didit отображаются ваш логотип и URL политики конфиденциальности, так же как в эндпоинте для одной сессии. Настройка выполняется в разделе Console → Customization.

Кэширование и задержка

Кэширование не используется: при каждом вызове отчёт формируется заново из актуальных данных, поэтому отчёт, запрошенный после ручной проверки, отражает решение проверяющего. Два вызова могут вернуть файлы с разным содержимым в байтах. Если нужна неизменяемая копия, сохраняйте скачанный файл в архив. Формирование выполняется синхронно и загружает каждое сохранённое изображение каждой включённой сессии, поэтому у пользователя с большим количеством сессий с медиафайлами ответ может занять десятки секунд. Установите большой таймаут чтения на клиенте (рекомендуется 120 с) и записывайте тело ответа на диск потоком. Генерация останавливается по серверному лимиту времени, а не продолжается до тех пор, пока клиент не прервёт запрос. Если лимит достигнут, отчёт всё равно возвращается как корректный PDF с самыми последними сессиями, а на титульной странице указано, сколько сессий пропущено.

Завершающий слеш

Канонический маршрут заканчивается завершающим слешем (…/generate-pdf/). Запрос без слеша обрабатывается напрямую и возвращает тот же ответ: редиректа 301 нет, поэтому клиенту не нужно следовать перенаправлениям, а curl не требует -L. Используйте URL со слешем, как в примерах: именно такой вид есть в спецификации OpenAPI и в ваших логах.

Ошибки

Примеры

Разрешения

Вызвать этот эндпоинт может любой активный API-ключ приложения. API-ключи Didit привязаны к приложению, а не к роли. Роли и разрешения Console (роли и разрешения, включая read:users и остальные) определяют, что может делать человек в Console, и не проверяются для трафика Management API. Ключ может экспортировать только пользователей своего приложения.

Связанные материалы

Авторизации

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.

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

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

Ваш уникальный идентификатор пользователя — произвольная строка (НЕ UUID). Это то же значение, которое вы передавали в vendor_data при создании сессий пользователя; сопоставляется в точности в переданном виде. Примените URL-encoding; значение, содержащее /, не может быть адресовано этим маршрутом.

Ответ

Сформированный PDF-документ, возвращаемый напрямую как бинарные данные application/pdf — без обёртки JSON и без перенаправления по URL для скачивания. Тело ответа начинается с сигнатуры %PDF. Сохраните его в файл .pdf или передайте потоком вызывающей стороне.

The response is of type file.

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