API REST
Strata está construido sobre una API REST descrita por una especificación OpenAPI 3.1. La mayoría de las integraciones utilizan el servidor MCP en lugar de llamar directamente a REST, pero la especificación completa está disponible para herramientas y clientes personalizados.
Especificación OpenAPI
La especificación legible por máquina se sirve en vivo y permanece sincronizada con la API desplegada. Ábrela directamente, o impórtala en un visor como Scalar, Redoc, Postman o Insomnia:
Abrir openapi.jsonLa especificación también se anuncia para agentes y crawlers a través de /.well-known/api-catalog.
URL base y versionado
Todos los endpoints se encuentran bajo /api/v1 en el host de la API; el prefijo de ruta lleva la versión.
Autenticación
Las solicitudes llevan un token Bearer. Las sesiones de navegador usan un token de acceso de corta duración generado a partir de una cookie de actualización HttpOnly; el acceso MCP programático usa OAuth 2.1, que gestiona la emisión y renovación de tokens automáticamente.
Áreas de recursos
La API abarca todo el dominio de Strata. Las principales áreas de recursos:
- Documentos: CRUD, historial, comentarios, sugerencias, acceso, publicación, imágenes
- Spaces: membresía, fuentes, permisos de acceso, búsqueda híbrida
- Empresas, organizaciones y niveles: la jerarquía del espacio de trabajo
- Usuarios y perfiles: cuentas, membresías, perfiles públicos
- Acceso y compartición: permisos, enlaces públicos, permisos de Spaces
- Autenticación y OAuth: sesiones, cambio de inquilino, clientes OAuth de MCP
- Agentes y tareas: invocación de agentes de plataforma y de usuario
- Administración y cumplimiento: SSO, SCIM, auditoría, retención, facturación
Generar un cliente
Apunta cualquier generador de código OpenAPI 3.1 a la especificación anterior para producir un cliente con tipos en el lenguaje de tu elección.
¿Prefieres herramientas sobre REST directo? Consulta la Referencia de herramientas MCP.