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

Быстрый старт

До первого ответа — три шага: получить ключ, проверить доступность, вызвать модуль.

Окружения

  • Окружение Продуктив
    Адрес https://api.inforensic.pro/v2
    Назначение Боевые данные, реальные списания
  • Окружение Тестовый стенд
    Адрес https://api.inforensic.dev/v2
    Назначение Интеграция и отладка, отдельный баланс

Состав модулей на стенде и продуктиве сверяйте через GET /v2/modules — это единственный источник истины о том, что доступно вашему ключу.

Ключ организации

  • Где взять
    Правила Личный кабинет платформы → раздел API-ключей организации
  • Заголовок
    Правила X-API-Key: <ключ> на каждом запросе
  • Типы ключей
    Правила Клиентский (списывает проверки) и сервисный (без списания)
  • Отзыв
    Правила Ключ деактивируется мгновенно; следующие запросы получат 401
  • Ограничения
    Правила Лимиты скорости привязаны к ключу (для MCP — 120 вызовов в минуту)

Ключ передаётся только заголовком X-API-Key. В URL и логи его не пишут; попавший в чужие руки ключ отзывается в кабинете.

Первый запрос

Доступность

# Доступность не требует ключа
curl https://api.inforensic.pro/v2/health

Первая проверка

# Первая проверка: дисквалифицированные лица ФНС
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"}'

Ключ модуля состоит из трёх сегментов: категория.юрисдикция.имя. Прежняя двухсегментная форма работает как псевдоним, но в ответе всегда приходит канонический ключ — не сравнивайте отправленный ключ с полученным напрямую.

Тарификация

  • Списание
    Правила До выполнения проверки, по тарифу модуля
  • Возврат
    Правила Автоматически при ошибке источника или внутреннем сбое
  • 402
    Правила Недостаточно средств на балансе организации
  • Бесплатно
    Правила GET /v2/modules, статусы и результаты задач, health

Тарифы видны в кабинете и по запросу GET /v2/billing/tariffs. Платите только за полученный ответ: при любой ошибке источника средства возвращаются автоматически.

Дальше