REST API

Strata построена на REST API, описанном спецификацией OpenAPI 3.1. Большинство интеграций используют сервер MCP, а не обращаются к REST напрямую, однако полная спецификация доступна для инструментов и собственных клиентов.

Спецификация

Спецификация OpenAPI

Машиночитаемая спецификация обслуживается в реальном времени и синхронизирована с развёрнутым API. Откройте её напрямую или импортируйте в просмотрщик, например Scalar, Redoc, Postman или Insomnia:

Открыть openapi.json

Спецификация также публикуется для агентов и краулеров через /.well-known/api-catalog.

Соглашения

Базовый URL и версионирование

Все эндпоинты расположены по пути /api/v1 на хосте API; префикс пути определяет версию.

Аутентификация

Запросы содержат токен Bearer. Браузерные сессии используют краткосрочный токен доступа, полученный из HttpOnly-куки обновления; программный MCP-доступ использует OAuth 2.1, который берёт на себя выдачу и обновление токенов.

Справочник

Ресурсные области

API охватывает весь домен Strata. Основные ресурсные области:

Документы: CRUD, история, комментарии, предложения, доступ, публикация, изображения
Spaces: участие, источники, гранты доступа, гибридный поиск
Компании, организации и уровни: иерархия рабочего пространства
Пользователи и профили: аккаунты, участие, публичные профили
Доступ и совместное использование: права, публичные ссылки, гранты Spaces
Аутентификация и OAuth: сессии, переключение тенантов, MCP OAuth-клиенты
Агенты и задачи: вызов платформенных и пользовательских агентов
Администрирование и соответствие требованиям: SSO, SCIM, аудит, хранение, биллинг

Клиенты

Генерация клиента

Направьте любой генератор кода OpenAPI 3.1 на приведённую выше спецификацию, чтобы получить типизированный клиент на нужном вам языке.

Предпочитаете инструменты вместо прямых REST-запросов? Смотрите Справочник инструментов MCP.