REST API
Общий адрес api.atomno-data.ru, подключение по ключу, состав доступных данных и справочники методов продуктов.
Обновлено:
Подключение по REST
Общий адрес REST API Atomno — https://api.atomno-data.ru.
REST подходит, когда данные запрашивает код вашего приложения: сайт, CRM,
справочник или собственный AI-помощник. Устанавливать MCP-клиент для этого не нужно.
Ключи, подписка и квота общие для REST API и MCP. Вторую подписку для другого интерфейса покупать не нужно. Ключи и расход запросов — в кабинете, лимиты и стоимость — на странице тарифов.
С чего начать
- Выберите продукт и прочитайте его состав и ограничения.
- Получите доступ в кабинете. Для знакомства есть пробный доступ; его состав указан перед подключением.
- Возьмите полный URL метода, формат запроса и заголовок авторизации из инструкции выбранного продукта. Один общий домен не означает, что любой префикс или метод уже доступен.
- Храните ключ на своём сервере, в переменной окружения. Не помещайте его в код браузера, открытый репозиторий или общедоступный файл настроек.
Общая схема:
Ваш интерфейс → ваш 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; следуйте инструкции выбранного метода.
Является ли пример ответа свежей проверкой моей организации?
Нет. Пример объясняет формат интерфейса. Для решения нужны фактический ответ по вашему запросу, источник, дата и статусы неполученных сведений.
