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