REST API (hosted)

Базовый URL api.atomno-mcp.ru, аутентификация по ключу, известные эндпоинты по сервисам. Полная OpenAPI-спецификация — по запросу с тестовым ключом.

Обновлено: 2026-07-06

Статус

Hosted REST API на https://api.atomno-mcp.ru работает в режиме закрытой беты: доступ по персональному ключу после согласования сценария и тарифа.

Публичный openapi.json на шлюзе пока не опубликован — отдаёт заглушку closed beta. Полная OpenAPI 3.x-спецификация (Swagger UI / JSON) выдаётся вместе с тестовым ключом или по запросу на интеграцию.

На этой странице — честный черновой справочник по известным путям из кода бэкендов и гайда для бизнеса. Точные контракты и лимиты фиксируются в договоре под ваш сценарий.

Базовые правила

Параметр	Значение
Базовый хост	`https://api.atomno-mcp.ru`
Формат	JSON (`Content-Type: application/json`)
Аутентификация	`Authorization: Bearer <ключ>` или `X-API-Key: <ключ>` (зависит от сервиса)
Ошибки	JSON с полями `error` / `message` / `message_ru`
Размещение	Серверы в РФ

Общая схема встраивания:

Ваш UI  →  ваш backend  →  api.atomno-mcp.ru/<сервис>/…  →  данные

Сервисы и префиксы

Каждый продукт линейки — отдельный префикс на общем хосте:

Сервис	Префикс	Готовность hosted	Примечание
СудАкт (судебная практика)	`/sudact`	пилот	Поиск + полный текст решений
ЕГРЮЛ / ЕГРИП	`/mcp-egrul/v1`	на финише	Карточки, поиск, bulk (Pro)
ФНС (проверка контрагента)	`/mcp-fns-check/v1`	на финише	Расширенные источники vs open-data
ФССП	`/mcp-fssp/v1`	планируется	Исполнительные производства
Госзакупки	`/zakupki/v1`	планируется	44-ФЗ / 223-ФЗ
ЦБ (курсы)	open-source	—	Self-host / PyPI, без hosted Pro

Актуальная матрица готовности — на Решения и Тарифы.

СудАкт (`/sudact`)

Пилотный hosted-сервис для legaltech и умного поиска по судебной практике РФ.

Метод	Путь	Ключ	Описание
`GET`	`/sudact/health`	нет	Liveness, версия сервиса
`POST`	`/sudact/v1/search`	да (`X-API-Key`)	Полнотекстовый поиск дел (как на sudact.ru)
`POST`	`/sudact/v1/citation`	да	Полный текст решения по `url` или `case_id`

Пример поиска:

curl -X POST https://api.atomno-mcp.ru/sudact/v1/search \
  -H "X-API-Key: <ваш-ключ>" \
  -H "Content-Type: application/json" \
  -d '{"query": "взыскание неустойки", "court_type": "arbitr", "limit": 10}'

Тело POST /v1/search (основные поля):

query — текст запроса (мин. 3 символа)
court_type — vs | arbitr | soyu | ks | any
instance — инстанция суда
norms — фильтр по статье закона
date_from / date_to — диапазон дат
limit — 1…50 (по умолчанию 10)

Тело POST /v1/citation:

url — ссылка на карточку sudact.ru или case_id из выдачи поиска
include_full_text — включить полный текст (по умолчанию true)
anonymize_level — none | physical_persons | all_persons

ЕГРЮЛ / ЕГРИП (`/mcp-egrul/v1`)

Карточки юрлиц и ИП, поиск по наименованию, bulk для Pro.

Метод	Путь	Ключ	Описание
`GET`	`/mcp-egrul/v1/health`	нет	Liveness
`GET`	`/mcp-egrul/v1/ready`	нет	Readiness (БД, кэш)
`GET`	`/mcp-egrul/v1/companies/inn/{inn}`	да	Карточка по ИНН (10 — юрлицо, 12 — ИП)
`GET`	`/mcp-egrul/v1/companies/ogrn/{ogrn}`	да	Карточка по ОГРН / ОГРНИП
`GET`	`/mcp-egrul/v1/companies/search`	да	Поиск по имени (`q`, `limit`, `only_active`)
`GET`	`/mcp-egrul/v1/companies/card`	да	Alias: `?inn=` или `?ogrn=`
`GET`	`/mcp-egrul/v1/companies/{inn}/founders`	да	Учредители (только 10-значный ИНН)
`GET`	`/mcp-egrul/v1/companies/{inn}/director`	да	Руководитель
`POST`	`/mcp-egrul/v1/companies/bulk`	Pro	До 100 ИНН в одном запросе

Пример:

curl https://api.atomno-mcp.ru/mcp-egrul/v1/companies/inn/7707083893 \
  -H "Authorization: Bearer <ваш-ключ>"

В ответах — заголовки X-RateLimit-* по тарифу.

ФНС — проверка контрагента (`/mcp-fns-check/v1`)

Hosted-режим расширяет open-source клиент: массовые реестры, РНП, AI-summary. Точный список эндпоинтов — в OpenAPI при выдаче ключа. Для smoke-теста:

curl https://api.atomno-mcp.ru/fns-check/health

(путь health может отличаться в production-конфиге Caddy — уточняем при онбординге.)

MCP вместо REST

Если внутри продукта уже есть AI-агент с tool-calling, можно подключить open-core MCP-клиенты с переменной ATOMNO_API_KEY — те же данные, меньше glue-кода. См. Для бизнеса →.

Что дальше

Обсудить интеграцию → — тестовый ключ и полная OpenAPI.
Решения для бизнеса → — сценарии и SLA.
Тарифы Pro → — лимиты и коммерческие серверы.