API REST

O Strata é construído sobre uma API REST descrita por uma especificação OpenAPI 3.1. A maioria das integrações usa o servidor MCP em vez de chamar o REST diretamente, mas a especificação completa está disponível para ferramentas e clientes personalizados.

Especificação

Especificação OpenAPI

A especificação legível por máquina é servida ao vivo e permanece sincronizada com a API implantada. Abra-a diretamente ou importe-a em um visualizador como Scalar, Redoc, Postman ou Insomnia:

Abrir openapi.json

A especificação também é anunciada para agentes e crawlers via /.well-known/api-catalog.

Convenções

URL base e versionamento

Todos os endpoints ficam sob /api/v1 no host da API; o prefixo de caminho carrega a versão.

Autenticação

As requisições carregam um token Bearer. Sessões de navegador usam um token de acesso de curta duração gerado a partir de um cookie de atualização HttpOnly; o acesso MCP programático usa OAuth 2.1, que cuida da emissão e da renovação de tokens por você.

Referência

Áreas de recursos

A API abrange todo o domínio do Strata. As principais áreas de recursos:

Documentos: CRUD, histórico, comentários, sugestões, acesso, publicação, imagens
Spaces: associação, fontes, permissões de acesso, pesquisa híbrida
Empresas, organizações e níveis: a hierarquia do workspace
Usuários e perfis: contas, associações, perfis públicos
Acesso e compartilhamento: permissões, links públicos, permissões de Spaces
Auth e OAuth: sessões, troca de inquilino, clientes OAuth de MCP
Agentes e tarefas: invocação de agentes de plataforma e de usuário
Administração e conformidade: SSO, SCIM, auditoria, retenção, faturamento

Clientes

Gerar um cliente

Aponte qualquer gerador de código compatível com OpenAPI 3.1 para a especificação acima e obtenha um cliente tipado na linguagem de sua escolha.

Prefere ferramentas ao invés de REST direto? Veja a Referência de Ferramentas MCP.