atomno data
На этой странице

Руководство разработчика

Документация API и MCP Atomno

От первого запроса до обработки ответа. Выберите продукт — его контракт и условия доступа собраны на одной странице.

Выберите продукт

Карточка товарного знака входит в отдельный пакет. Его состав — в каталоге данных.

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

  1. Получите доступ

    В кабинете выберите пробный доступ или подписку на нужный пакет.

  2. Создайте ключ

    Откройте API-ключи. Замените YOUR_API_KEY в примере своим ключом.

  3. Запросите реквизиты

    Этот GET возвращает базовую карточку компании по ИНН. Для сводной проверки есть отдельный POST-метод.

curl · базовые реквизиты
curl \
  https://api.atomno-mcp.ru/mcp-fns-check/v1/basic-info/7707083893 \
  -H "X-API-Key: YOUR_API_KEY"

Авторизация

Передавайте ключ заголовком X-API-Key. Для проверки контрагента и закупок поддерживается также Authorization: Bearer; в судебном API используйте X-API-Key.

Ключ — только на вашем сервере

Не помещайте его в JavaScript публичной страницы, URL или открытый репозиторий. Доступ и квота определяются подпиской на выбранный пакет.

Курсы Банка России работают через локальный MCP без платной подписки. Для них отдельный быстрый старт.

Читайте ответ

JSON · основные поля карточки
{
  "inn": "7707083893",
  "ogrn": "1027700132195",
  "kpp": "773601001",
  "name": {
    "short": "ПАО СБЕРБАНК"
  },
  "status": "active"
}

Сохранённый ответ от 2 августа 2026. Показаны основные поля; запрос сейчас не выполняется.

HTTP-успех ещё не означает, что все источники проверены. В сводной проверке смотрите package_checks[].state, дату источника и checked_at. Значение not_checked нельзя считать отсутствием риска.

Если запрос не удался

401 / 403

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

400 / 422

Сверьте ИНН, обязательные поля и формат JSON с документацией продукта.

429

Уменьшите частоту запросов. Проверьте квоту и ограничения тарифа.

502 / 503

Источник или сервис временно недоступен. Сохраните текст ошибки; не заменяйте отказ пустым успешным результатом.

Ошибки каждого метода описаны на странице продукта. Если проблема повторяется, напишите в поддержку: метод, время и код ответа. Сам ключ не отправляйте.