Судебная практика: параметры поиска

Новые подключения — скоро

Поиск судебных актов по тексту, виду суда и нормам права.

Охват зависит от подключённого корпуса. Подготовлены также тексты общей юрисдикции и мировых судов; их подключение к поиску — следующий этап.

Задача

Подбор практики для анализа правовой позиции.

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

Проверьте доступ
Новые подключения пока закрыты. Пример ниже предназначен для интеграции при наличии действующего доступа.
Подготовьте ключ
Используйте ключ с доступом к этому продукту из раздела API-ключи.
Выполните запрос с вашего сервера
Замените YOUR_API_KEY своим ключом. Начните с одного запроса, затем проверьте поля ответа.

curl · пример запроса

curl -X POST \
  https://api.atomno-mcp.ru/sudact/v1/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"злоупотребление правом вывод активов","court_type":"vs","norms":["10 ГК РФ"]}'

Доступ и авторизация

Заголовок ключа

X-API-Key: YOUR_API_KEY

Используйте X-API-Key с доступом к судебной практике.

Храните ключ на сервере вашего приложения. Не публикуйте его в клиентском коде и не передавайте в URL.

Запрос и параметры

POSThttps://api.atomno-mcp.ru/sudact/v1/search

JSON · тело запроса

{
  "query": "злоупотребление правом вывод активов",
  "court_type": "vs",
  "norms": [
    "10 ГК РФ"
  ]
}

Параметр	Назначение
`query`	Текст поискового запроса
`court_type`	Тип суда; vs — Верховный суд
`norms`	Нормы права

Ответ и поля

JSON · учебный пример

{
  "cases": [],
  "total_found": 0
}

Учебный фрагмент структуры ответа. Это не результат проверки компании или поиска документов.

Поле	Что содержит
`cases`	Найденные дела
`total_found`	Количество результатов
`search_meta`	Сведения о поиске
`date_decided`	Дата судебного акта
`date_note`	Уточнение к дате, если требуется
`url / source_site`	Ссылка и источник

Ошибки

HTTP	Причина и действие
`401`	Ключ отсутствует или не принят Проверьте заголовок и действующий ключ.
`403`	Нет доступа к продукту Проверьте подключённый пакет и срок подписки.
`400 / 422`	Ошибка параметров Исправьте формат и обязательные поля запроса.
`429`	Превышен лимит Уменьшите частоту и проверьте остаток квоты.
`502 / 503`	Источник или сервис недоступен Не трактуйте отказ как отсутствие данных; сохраните код и текст ошибки.

При повторяющейся ошибке сообщите поддержке метод, время запроса и код ответа. Ключ отправлять не нужно.

Условия использования

Для вызова требуется ключ X-API-Key с доступом к судебной практике. Новые подключения временно недоступны.

Поиск человека по фамилии не предоставляется.

Происхождение данных

Корпус включает опубликованные судебные акты. Часть документов получена через sudact.ru, другие наборы — с судебных сайтов. Поля url и source_site сохраняют происхождение конкретного документа.

Все инструменты