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

Поддержка KYC и KYB

Поддерживает сессии как Проверки пользователей (KYC), так и Верификации бизнеса (KYB). Didit автоматически выбирает подходящий шаблон PDF:
  • Сессия Проверки пользователей (KYC): отчёт с разделами верификации личности, проверки живости, сравнения лиц, AML и POA.
  • Сессия Верификации бизнеса (KYB): отчёт с разделами реестра компаний, ключевых лиц (UBO и должностных лиц), документов, AML, анкеты, телефона, электронной почты и анализа IP, если эти функции входят в сценарий.
Оба варианта используют один и тот же конвейер генерации PDF и поддерживают кастомизацию White label (логотип, URL политики конфиденциальности).

Соглашение об именовании файлов

Возвращается через заголовок Content-Disposition: attachment; filename=....

Требование к статусу

Чтобы сгенерировать PDF, сессия должна находиться в статусе APPROVED, DECLINED или IN_REVIEW. Сессии в процессе выполнения или ещё не начатые возвращают 403.

Примеры

White label

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

Разрешение

Требуется read:sessions. Для обоих типов используется одна и та же область доступа.

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

Авторизации

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) или Верификации бизнеса (KYB) для отображения — session_id, возвращаемый методом POST /v3/session/. Один и тот же путь подходит для обоих типов сессий; используйте имя файла в заголовке Content-Disposition ответа, чтобы определить полученный тип отчёта.

Должен быть корректно сформированным UUID в нижнем регистре. Маршрут сопоставляется только с валидными UUID, поэтому некорректное значение отклоняется маршрутизатором URL ещё до выполнения кода приложения, и ответом будет HTML-страница 404, а не оболочка JSON {"detail": ...}, показанная ниже. Конвертер UUID маршрута поддерживает только каноническую форму в нижнем регистре — UUID с шестнадцатеричными символами в верхнем регистре отклоняются с HTML-ошибкой 404.

Пример:

"11111111-2222-3333-4444-555555555555"

Ответ

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

The response is of type file.

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