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

LexaAI API

LexaAI API – программный доступ к законодательству, разъяснениям и судебной практике в виде дословных выдержек с указанием источника. Текущая область – кадастровая оценка и налогообложение недвижимости; следующие области – банкротство и строительство.

Базовый адрес – https://api.lexaai.ru. Ответы – JSON, ключ передается в заголовке запроса.

По ключу API доступны данные без ИИ-агента LexaAI: /v1/research в режиме по умолчанию, /v1/search и /v1/practice/*. Доступ по ключу бесплатный: число запросов не ограничено, действует только ограничение частоты. Ответы ИИ-агента LexaAI (/v1/answer) и режимы с ним по ключу недоступны – они доступны в чате app.lexaai.ru.

Для кого

Разработчики ИИ-агентов и юридических сервисов. Сервис отдает материалы в машиночитаемом виде: у каждого фрагмента есть реквизиты источника и хеш текста, у досье – перечень того, чего не хватило. Перечень инструментов агент получает сам: GET /v1/tools.
Юридические команды, которым нужна проверяемая подборка по вопросу: нормы, разъяснения высших судов и государственных органов, судебные акты с реквизитами.

Слои и конвейер

Слой	Что содержит	Поле ответа
Законодательство	нормативные правовые акты текущей области права	`law`
Разъяснения	разъяснения судов, в том числе высших, и разъяснения государственных органов	`clarifications`
Судебная практика	судебные акты по спорам о кадастровой стоимости и налогах, исчисляемых от нее	`practice`

Нормы выдаются в редакции на дату запроса (as_of), если она загружена. Если редакции на запрошенную дату нет, шлюз сообщает об этом в ответе, а не подставляет другую молча.

Сведения о слое практики возвращаются в поле practice_coverage ответов /v1/research и /v1/answer, дата самого позднего акта – в поле corpus_max_date.

POST /v1/research и POST /v1/answer проходят слои в фиксированном порядке: закон, затем разъяснения, затем практика. Порядок и обязательность этапов заданы кодом шлюза, а не указанием модели: пропустить слой нельзя, пустой результат этапа тоже фиксируется в ответе.

Принципы

Дословность. Выдача поиска – фрагменты исходных текстов без пересказа. Ответ /v1/answer пишет языковая модель только по материалам досье, а сервер побайтово сверяет закавыченные цитаты с этими материалами и сообщает результат в поле citation_check.
Провенанс. У каждого фрагмента – реквизиты документа и хеш sha256 текста, по которому выдержку можно сверить с источником.
Явный отказ. Если слой недоступен, ответ содержит available: false и причину, а не пустой «успешный» результат. Если материалов для ответа нет, ответ не формируется. Все пробелы перечисляются в поле gaps.
Раздельные слои. Нормы и практика не смешиваются в общем ранжировании: судебный акт не может вытеснить норму или разъяснение.

Чего сервис не делает

Не консультирует. Каждый ответ содержит дисклеймер: «Справочная информация на основе дословных выдержек из правовых источников; не является юридической консультацией. Применимость норм и правовых позиций к конкретным обстоятельствам требует проверки юристом. Клиент API обязан транслировать этот дисклеймер конечному пользователю.»

Разделы документации

Быстрый старт – ключ в кабинете и первые запросы на curl и Python.
Авторизация и лимиты – ключи, ограничение частоты, единицы учета, что недоступно по ключу, GET /v1/usage.
Исследование – досье по вопросу без ответа модели.
Ответ по досье – ответы ИИ-агента LexaAI со сверкой цитат; по ключу API недоступен.
Федеративный поиск – законодательство и практика одним запросом.
Судебная практика – поиск, перечни дел, распределения, история спора.
Эндпоинты и инструменты, Язык запросов, Фильтры практики – справочник, собранный из манифеста шлюза.
Ошибки и деградация – коды ответов и повторы.
Версии и изменения – политика версий и журнал изменений.
Правила использования API – обязанности клиента.