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