Комплексная проверка физлица

Один запрос запускает полный набор проверок по человеку и собирает готовый профиль риска. Проверка асинхронная: задача, прогресс, отчёт.

Шаг 1. Создать задачу

POST /v2/check/person/

# Шаг 1: один запрос запускает все проверки физлица
curl -X POST https://api.inforensic.pro/v2/check/person/ \
  -H "X-API-Key: $CONTEXT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_data": {
      "last_name": "Иванов",
      "first_name": "Иван",
      "middle_name": "Иванович",
      "birth_date": "1980-01-01"
    }
  }'

Ответ

{
  "job_id": "0dd162ec-22ec-4d9a-9531-626c9658a9f5",
  "data_completeness": 35,
  "modules": [ "mvd_wanted", "fssp_criminal_wanted", "general_courts", "…" ],
  "report_url": "/v2/check/person/{job_id}/report"
}

Данные обязательно обёрнуты в person_data — плоский объект вернёт 400 с текстом «person_data обязателен». data_completeness показывает, насколько полны входные данные: по ФИО с датой рождения запускается 18 модулей, паспорт, ИНН и СНИЛС расширяют набор и повышают точность сопоставления.

Шаг 2. Следить за выполнением

Опрос или поток

# Шаг 2, вариант А: опрос статуса
curl https://api.inforensic.pro/v2/check/person/$JOB_ID/status \
  -H "X-API-Key: $CONTEXT_KEY"
→ { "status": "processing", "progress": 94, "completed_tasks": 17, "total_tasks": 18, "is_complete": false }

# Шаг 2, вариант Б: поток событий (SSE)
curl -N https://api.inforensic.pro/v2/check/person/$JOB_ID/stream \
  -H "X-API-Key: $CONTEXT_KEY"

Поток предпочтительнее опроса: проверка занимает от полутора до пяти минут, и большую часть времени ждёт самый медленный источник. События потока: connected, task_completed, task_failed, job_completed, heartbeat.

Шаг 3. Забрать отчёт

GET /v2/check/person/{job_id}/report

# Шаг 3: отчёт целиком
curl https://api.inforensic.pro/v2/check/person/$JOB_ID/report \
  -H "X-API-Key: $CONTEXT_KEY"

Пока задача не завершена, приходит 409 с понятным телом. Отчёт содержит результат каждой проверки, единый риск-профиль с факторами и машиночитаемую выжимку (person_de) для загрузки в ваши системы. По этому же контуру доступен PDF — ссылка приходит в ответе задачи.

Когда брать контур целиком

Нужен готовый профиль риска по человеку — берите комплексную проверку. Нужен один факт — паспорт, ИНН, санкции — вызывайте отдельный модуль. Оба способа используют один баланс и одинаковую тарификацию.