Отчёт по заявителю (PDF / HTML)¶
GET /v1/applicants/{externalUserId}/report возвращает аудиторский
case-file заявителя — тот же документ, что видят операторы в портале
по кнопке «Распечатать отчёт», только отрендеренный на сервере.
Используется для регуляторных аудитов, архивирования, прикрепления
ко внутренним заметкам по делу.
Использование¶
curl -X GET 'https://api.compliance.example/v1/applicants/user-12345/report?format=pdf&lang=ru' \
-H 'X-Api-Key: pk_live_...' \
-H 'X-Api-Secret: ...' \
-H 'X-Environment: production' \
-o user-12345.pdf
Параметры запроса¶
| Параметр | Значения | По умолчанию | Эффект |
|---|---|---|---|
format |
pdf | html |
pdf |
Формат вывода |
lang |
en | ru |
en |
Язык отчёта |
Что входит в отчёт¶
Фиксированный партнёрский набор: блок статуса, профиль, документы (со встроенными data-URI изображениями — последнее одобренное на каждый уровень). Внутренние операторские разделы (заметки, EXIF, device intel) исключены — партнёр получает безопасный для интеграции subset.
В партнёрской поверхности нет параметра ?include= — рендерер всегда
эмитит партнёрский набор. Селектор разделов остаётся в операторском
портале.
Примечания¶
- Синхронно и блокирующе. Крупные KYB-кейсы (10+ дочерних) могут занять несколько секунд. Если у вашего шлюза жёсткий таймаут — планируйте; асинхронный режим для долгих случаев — в roadmap.
Content-Typeотражает выбранный формат —application/pdfилиtext/html.- Каждое скачивание попадает в аудит — событие
applicant.report_downloadedпоявляется в/review-historyсactorType=partner. - Совпадает с порталом за вычетом партнёрской фильтрации
разделов — оба источника зовут один рендерер
(
ApplicantReportEndpoint.RenderForApplicantAsync).
Вебхуки vs отчёт¶
Если нужно реагировать на вердикт — используйте вебхук
applicantReviewed (дёшево, push). Отчёт — для архивирования:
выпустите его один раз при терминальном решении и сохраните байты
на своей стороне.