К содержанию
Инфорензик

Модули и задачи

Все проверки платформы доступны через один контракт: паспорт модуля описывает вход, вызов исполняет проверку, конверт ответа одинаков от первого до последнего модуля.

Семь адресов на всю платформу

  • Эндпоинт GET /v2/modules
    Назначение Реестр модулей со схемами входа и ценой
    Списание бесплатно
  • Эндпоинт GET /v2/modules?category=compliance
    Назначение Фильтр по категории или юрисдикции
    Списание бесплатно
  • Эндпоинт GET /v2/modules/{key}
    Назначение Паспорт одного модуля
    Списание бесплатно
  • Эндпоинт POST /v2/modules/{key}/execute
    Назначение Синхронный вызов, ответ в том же запросе
    Списание по тарифу модуля
  • Эндпоинт POST /v2/modules/{key}/execute_async
    Назначение Постановка задачи, возвращает task_id
    Списание по тарифу модуля
  • Эндпоинт GET /v2/task/{task_id}/status
    Назначение Статус задачи и прогресс
    Списание бесплатно
  • Эндпоинт GET /v2/task/{task_id}/result
    Назначение Результат завершённой задачи
    Списание бесплатно

Реестр отдаёт схемы входа и цену, поэтому клиент строит запрос без ручной сверки с документацией. Паспорта всех модулей продублированы в каталоге этого раздела.

Синхронно или задачей

Быстрые модули

# Синхронный вызов: ответ приходит в том же запросе
curl -X POST https://api.inforensic.pro/v2/modules/\
  compliance.rus.fns_disqualified/execute \
  -H "X-API-Key: $CONTEXT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"last_name":"Петрова","first_name":"Елена","birth_date":"1978-03-12"}'

Долгие источники

# Асинхронный вызов: задача и опрос статуса
curl -X POST https://api.inforensic.pro/v2/modules/\
  compliance.rus.general_courts/execute_async \
  -H "X-API-Key: $CONTEXT_KEY" -d '{...}'
→ {"task_id":"550e8400-e29b-41d4-a716-446655440000"}

curl https://api.inforensic.pro/v2/task/$TASK_ID/status  # pending → processing → completed
curl https://api.inforensic.pro/v2/task/$TASK_ID/result

Локальные проверки и быстрые реестры отвечают за секунды — берите execute. Источники с браузерным обходом и капчей (суды, розыск) выполняются дольше — ставьте execute_async и следите за задачей. Состав полей каждого модуля виден в его паспорте.

Статусы задач

  • Статус pending
    Что означает Задача принята и стоит в очереди
  • Статус processing
    Что означает Выполняется; для долгих операций приходит progress 0–100
  • Статус completed
    Что означает Завершена, результат доступен
  • Статус failed
    Что означает Завершена с ошибкой, средства возвращены
  • Статус not_found
    Что означает Задача не найдена (истёк срок хранения или неверный id)

Единый конверт ответа

Структура ответа

{
  "status": "COMPLETED",
  "success": true,
  "module_name": "compliance.rus.fns_disqualified",
  "data": {
    "found": true, "total_count": 1,
    "results": [ /* записи источника — свои у каждого модуля */ ],
    "risk_profile": { "overall_level": "B_YELLOW", "flags": [ … ] },
    "data_actual_date": "2026-09-27"
  },
  "metadata": { "request_id", "processing_time_ms" },
  "error": null
}

Поля верхнего уровня одинаковы у всех модулей. Внутри data — записи конкретного источника, статистика и риск-профиль. Дата актуальности data_actual_date отделяет «в источнике пусто» от «источник обновлялся давно».

Риск-профиль

  • Уровень A_GREEN
    Значение Негативных признаков не найдено
  • Уровень B_YELLOW
    Значение Найдены умеренные признаки, требуют внимания
  • Уровень C_ORANGE
    Значение Выраженный риск: нарушения, споры, ограничения
  • Уровень D_RED
    Значение Критический признак: санкции, розыск, дисквалификация

Каждый ответ несёт risk_profile: общий уровень, взвешенный балл и список факторов с категориями (уголовный, административный, финансовый, миграционный…). Профиль считается из найденных записей, поэтому «пустой» источник — это A_GREEN без факторов, а не отсутствие ответа.

Ошибки

  • Код 400
    Причина Запрос не прошёл валидацию
  • Код 401
    Причина Ключ отсутствует, отозван или неактивен
  • Код 402
    Причина Недостаточно средств на балансе организации
  • Код 404
    Причина Модуль или задача не найдены
  • Код 422
    Причина Поля не соответствуют схеме модуля
  • Код 429
    Причина Превышен лимит вызовов для ключа (актуально для MCP)
  • Код 500
    Причина Внутренняя ошибка, средства возвращены
  • Код 503
    Причина Источник временно недоступен, средства возвращены
  • Код 504
    Причина Источник не уложился в таймаут модуля, средства возвращены

При ошибке источника, таймауте и внутреннем сбое списанные средства возвращаются на баланс автоматически: платить за неполученный ответ не нужно.

PDF-отчёт по модулю

  • Эндпоинт POST /v2/modules/{key}/pdf
    Назначение Поставить задачу печати результата последнего запуска
  • Эндпоинт GET /v2/modules/pdf/{pdf_task_id}/status
    Назначение Статус задачи печати
  • Эндпоинт GET /v2/modules/pdf/{pdf_task_id}/download
    Назначение Скачать готовый PDF

PDF печатается из снимка результата: повторного обращения к источнику и повторного списания нет.