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

После логина разработчик видит панель с ключевыми метриками:

Тут же — 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 категориях

Полный каталог инструментов доступен в документации с поиском и фильтрацией по категориям:

Для каждого инструмента есть: описание, категория, диапазон стоимости.

Три транспорта

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 минут до первого запроса

Документация содержит примеры для пяти сценариев интеграции:

1. Claude Code — одна команда в терминале
2. Claude Desktop — JSON-конфиг в файл
3. cURL — REST API напрямую
4. Python — клиентская обёртка с requests
5. 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 и безопасность

Каждый ответ содержит заголовки 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:

Бэкенд общий — те же эндпоинты, та же база, тот же cost tracking. Портал — это другой интерфейс к той же инфраструктуре.

Кому это нужно

LegalTech-стартапы — интегрировать поиск судебной практики в свой продукт без построения собственного индекса.

Юридические фирмы с IT-отделом — автоматизировать due diligence, мониторинг законодательства, подготовку процессуальных документов.

AI-разработчики — подключить юридические инструменты к своим агентам через MCP-протокол.

Исследователи — массовый анализ судебной практики через batch API.

Один портал. Три транспорта. 56 инструментов. От регистрации до первого запроса — 5 минут. platform.legal.org.ua