Developer Platform: 56 юридических AI-инструментов через один API
Мы открыли platform.legal.org.ua — портал для разработчиков, которые хотят интегрировать юридический AI в свои продукты. API-ключи, аналитика использования, документация на 56 инструментов, примеры для Python и TypeScript. MCP SSE, REST, batch — три транспорта на выбор. От регистрации до первого запроса — 5 минут.
Developer Platform: 56 юридических AI-инструментов через один API
Как мы построили портал для разработчиков, которые хотят интегрировать юридический AI в свои продукты.
Зачем отдельный портал
LEX AI начинался как инструмент для юристов. Но разработчики тоже хотят доступ к нашим данным: поиск судебной практики, проверка контрагентов, анализ законодательства — всё это нужно не только в нашем UI, но и в сторонних продуктах.
Раньше интеграция выглядела так: написать нам в Telegram, получить токен, прочитать README на GitHub, разобраться в форматах ответов методом проб и ошибок. Это не масштабируется.
Теперь есть platform.legal.org.ua — полноценный developer portal со всем необходимым для интеграции.
Что внутри
Dashboard
После логина разработчик видит панель с ключевыми метриками:
| Метрика | Описание |
|---|---|
| Активные API-ключи | Количество созданных ключей |
| Баланс | Остаток в USD |
| Запросы за 30 дней | Общее количество вызовов |
| Статус API | Текущая доступность |
Тут же — Quick Start секция с готовой командой для подключения через Claude Code:
claude mcp add secondlayer \
--transport sse \
--url https://mcp.legal.org.ua/v1/sse \
--header "Authorization: Bearer YOUR_API_KEY"
Управление API-ключами
Полный CRUD для ключей:
- Создание — ввели название, получили ключ. Формат:
sl_<32 символа>_<8 контрольная сумма>. - Безопасность — ключ показывается один раз после создания. Сохраняйте сразу.
- Трекинг — для каждого ключа видно количество вызовов, дату создания и последнего использования.
- Отзыв — мгновенный, с подтверждением.
Аналитика использования
Страница Usage показывает детальную статистику:
- График вызовов по дням — бар-чарт за 7, 30 или 90 дней
- Использование по инструментам — таблица с количеством вызовов, стоимостью, токенами, средним временем ответа
- Финансовый дашборд — текущий баланс, история транзакций (пополнения / использование)
Каждый вызов API трекается с точностью до токена. Разработчик видит, сколько стоит каждый инструмент, и может оптимизировать расходы.
56 инструментов в 12 категориях
Полный каталог инструментов доступен в документации с поиском и фильтрацией по категориям:
| Категория | Количество | Примеры |
|---|---|---|
| Pipeline | 4 | Полный анализ запроса, классификация намерения |
| Court | 4 | Поиск судебных решений, детали дела |
| Analysis | 10 | Сравнение решений, извлечение паттернов |
| Documents | 8 | Загрузка, парсинг, анализ документов |
| Legislation | 7 | Поиск статей, полный текст закона |
| Procedural | 3 | Сроки, подсудность, процессуальные действия |
| Parsing | 5 | Разбор текста решения на компоненты |
| Vault | 3 | Хранилище документов пользователя |
| RADA | 4 | Депутаты, законопроекты, голосования |
| Registry | 5 | ЕГРПОУ, бенефициары, должники |
| Statistics | 2 | Статистика по судам и категориям |
| Main | 1 | Главный инструмент оркестрации |
Для каждого инструмента есть: описание, категория, диапазон стоимости.
Три транспорта
Developer Platform поддерживает три способа интеграции:
MCP SSE (рекомендуемый)
Server-Sent Events по протоколу MCP. Поддерживается Claude Desktop, Claude Code и другими MCP-клиентами "из коробки".
Endpoint: https://mcp.legal.org.ua/v1/sse
REST API
Классический HTTP для любого языка программирования.
curl -X POST https://mcp.legal.org.ua/api/tools/search_court_decisions \
-H "Authorization: Bearer sl_your_key" \
-H "Content-Type: application/json" \
-d '{"query": "признание сделки недействительной"}'
Batch Processing
Несколько инструментов в одном запросе:
POST /api/tools/batch
Quick Start: 5 минут до первого запроса
Документация содержит примеры для пяти сценариев интеграции:
- Claude Code — одна команда в терминале
- Claude Desktop — JSON-конфиг в файл
- cURL — REST API напрямую
- Python — клиентская обёртка с requests
- TypeScript/Node.js — axios-клиент с типизацией
Пример на Python:
import requests
API_KEY = "sl_your_api_key"
BASE_URL = "https://mcp.legal.org.ua/api/tools"
response = requests.post(
f"{BASE_URL}/search_court_decisions",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"query": "взыскание долга по кредитному договору"}
)
decisions = response.json()
Rate Limits и безопасность
| Параметр | Значение |
|---|---|
| Запросы в минуту | 60 |
| Запросы в день | 10 000 |
| Макс. размер запроса | 10 MB |
| Timeout выполнения | 120 секунд |
Каждый ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. При превышении — 429 с рекомендацией exponential backoff.
Аутентификация — Bearer-токен в заголовке Authorization. Ключи привязаны к аккаунту, каждое использование логируется. Если ключ скомпрометирован — отзыв мгновенный через панель.
Биллинг
Модель pay-as-you-go. Каждый вызов инструмента имеет свою стоимость, которая зависит от сложности: простые запросы (поиск по реестру) стоят меньше, чем глубокий анализ с использованием LLM.
На странице Usage видно:
- Текущий баланс
- Общая сумма пополнений
- Общая сумма использования
- История транзакций с типом (purchase / usage) и описанием
Архитектура портала
Developer Platform — это отдельный React SPA, независимый от основного legal.org.ua:
| Компонент | Технология |
|---|---|
| Frontend | React 19, Vite, TailwindCSS |
| Графики | Recharts |
| Auth | Google OAuth + email/password |
| API | mcp_backend (общий с основным приложением) |
| Deploy | Docker + Nginx, порт 8094 |
Бэкенд общий — те же эндпоинты, та же база, тот же cost tracking. Портал — это другой интерфейс к той же инфраструктуре.
Кому это нужно
LegalTech-стартапы — интегрировать поиск судебной практики в свой продукт без построения собственного индекса.
Юридические фирмы с IT-отделом — автоматизировать due diligence, мониторинг законодательства, подготовку процессуальных документов.
AI-разработчики — подключить юридические инструменты к своим агентам через MCP-протокол.
Исследователи — массовый анализ судебной практики через batch API.
Один портал. Три транспорта. 56 инструментов. От регистрации до первого запроса — 5 минут. platform.legal.org.ua