Введение
Устройство платформы
Публичные адреса, требования к подключению и способы интеграции.
LegalStack — облачная платформа. Для интеграции доступны REST API, MCP-серверы для AI-агентов и вебхуки — все они работают через публичные адреса ниже.
Публичные адреса
| Адрес | Назначение |
|---|---|
https://api.legalstack.ru | REST API (/api/v1/*), OAuth 2.0 (/oauth/*), метаданные (/.well-known/*) |
https://mcp.legalstack.ru | MCP-серверы для AI-агентов |
https://app.legalstack.ru | Веб-приложение |
https://docs.legalstack.ru | Эта документация |
https://legalstack.ru | Сайт |
Требования к подключению
- Только HTTPS с TLS 1.3. Запросы по HTTP перенаправляются на HTTPS, соединения с TLS 1.2 и ниже отклоняются.
- Поддерживаются HTTP/2 и HTTP/3.
- Авторизация — OAuth 2.0, токен передаётся в заголовке
Authorization: Bearer <токен>. Как получить токен — в гайде Аутентификация. - Лимиты частоты запросов — в гайде Лимиты запросов, безопасный повтор изменяющих запросов — в гайде Идемпотентность.
Способы интеграции
- REST API — справочник операций. Спецификация OpenAPI 3.1 каждого раздела доступна по адресу
https://docs.legalstack.ru/openapi/<раздел>.json. - MCP-серверы — подключение и инструменты для AI-агентов и MCP-клиентов.
- Вебхуки — подписка и проверка подписи, каталог событий.
Данные и изоляция
Все данные принадлежат команде. Запросы выполняются в границах команды, к которой относится токен, и с правами пользователя; данные разных команд изолированы на уровне хранилища.