Перейти к основному содержанию

REST API

Общий адрес api.atomno-data.ru, подключение по ключу, состав доступных данных и справочники методов продуктов.

Обновлено:

Подключение по REST

Общий адрес REST API Atomno — https://api.atomno-data.ru. REST подходит, когда данные запрашивает код вашего приложения: сайт, CRM, справочник или собственный AI-помощник. Устанавливать MCP-клиент для этого не нужно.

Ключи, подписка и квота общие для REST API и MCP. Вторую подписку для другого интерфейса покупать не нужно. Ключи и расход запросов — в кабинете, лимиты и стоимость — на странице тарифов.

С чего начать

  1. Выберите продукт и прочитайте его состав и ограничения.
  2. Получите доступ в кабинете. Для знакомства есть пробный доступ; его состав указан перед подключением.
  3. Возьмите полный URL метода, формат запроса и заголовок авторизации из инструкции выбранного продукта. Один общий домен не означает, что любой префикс или метод уже доступен.
  4. Храните ключ на своём сервере, в переменной окружения. Не помещайте его в код браузера, открытый репозиторий или общедоступный файл настроек.

Общая схема:

Ваш интерфейс → ваш backend → REST API → api.atomno-data.ru → данные

Подтверждённый состав продуктов

ПродуктСостав и ограниченияСправочник
Проверка контрагентаКарточка организации, копии ФНС, сведения МСП и четыре официальных перечня. Банкротство, приставы и арбитраж не подтвержденыПроверка контрагента
ЗакупкиПоиск тендеров. Полнота выгрузки, аналитика поставщика и остальные методы отдельно не подтвержденыКлиент закупок
Товарные знакиКарточка по номеру свидетельства. Поиск по названию и оценка сходства не входятКлиент товарных знаков

Подтверждение состава данных не означает, что все инструменты клиента доступны через REST. Полный URL запроса и действующие методы проверяйте в инструкции подключения продукта.

Остальные направления

  • ЕГРЮЛ — отдельное подключение пока не открыто.
  • Санкционные перечни — четыре перечня внутри проверки контрагента; отдельного подключения нет.
  • ФССП — источник для отдельного подключения ещё не настроен.
  • Судебные акты — доступен поиск актов арбитражных судов, судов общей юрисдикции и Верховного суда и получение текста найденного акта. Карточки ФАС — отдельные ведомственные данные. Поиск включает мировых судей; полнота зависит от источника, суда и периода. Для части актов используется исторический локальный архив. Параметры и ограничения — в справочнике REST; условия подключения — на странице продукта.
  • Лекарства — клиент подключается по ключу; новый размещённый доступ здесь пока не выдаём. Инструкций к препаратам нет.
  • Курсы ЦБ и налоговые калькуляторы можно подключать как отдельные клиенты. Работа локального расчёта не подтверждает размещённый REST-метод.

Формат запроса и авторизация

ПараметрГде смотреть
Полный URL и HTTP-методВ инструкции подключения выбранного продукта
АвторизацияЗаголовок Authorization: Bearer или X-API-Key — по инструкции метода
Входные поля и ответВ справочнике метода; формат обмена — JSON
ЛимитыВ тарифе и кабинете
Источник и ограниченияНа странице продукта и в описании источников

В примерах справочников переменная ATOMNO_METHOD_URL означает полный URL конкретного метода. Задайте её по инструкции подключения: это не базовый домен и не разрешение добавлять к нему произвольные пути.

Недоступный источник или непроверенный метод не означают успешную проверку. Не подменяйте отказ пустым списком или выводом «рисков нет».

MCP вместо REST

Если внутри приложения уже работает агент с вызовом инструментов, можно подключить MCP-клиент. Имена переменных и конфигурация приведены на странице каждого сервера. Как выбрать REST или MCP.

Для подключения собственной системы: интеграции под заказ.

Частые вопросы

Что подставлять в ATOMNO_METHOD_URL?

Полный URL конкретного метода из инструкции подключения выбранного продукта. Это не базовый домен и не произвольно составленный путь. HTTP-метод, заголовок авторизации и входные поля также берутся из инструкции этого метода.

Нужна ли отдельная подписка для REST и MCP?

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

Как встроить проверку контрагента в собственный сайт?

Запрос к доступному методу выполняйте с бэкенда сайта, используя формат и авторизацию из инструкции продукта. Ответ и статусы отдельных источников показывайте в своём интерфейсе; MCP-хост пользователю не нужен.

Что делать, если API вернул ошибку источника?

Сохраните её как неполученные сведения и отличайте от корректного ответа без совпадений. Для разбора нужны метод, время и обезличенное сообщение ошибки, но не секретный ключ.

Что проверить перед передачей API-ответа внешней модели?

Проверьте состав ответа и передавайте только нужные для задачи сведения. Ключ авторизации не должен попадать в текст запроса модели; для судебных текстов учитывайте предусмотренное продуктом обезличивание.

Подойдёт ли заголовок авторизации от одного сервиса другому?

Не переносите его без сверки. Например, проверка контрагента использует Authorization: Bearer, а сервис налоговых проверок — X-API-Key; следуйте инструкции выбранного метода.

Является ли пример ответа свежей проверкой моей организации?

Нет. Пример объясняет формат интерфейса. Для решения нужны фактический ответ по вашему запросу, источник, дата и статусы неполученных сведений.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть