API REST
Strata repose sur une API REST décrite par une spécification OpenAPI 3.1. La plupart des intégrations passent par le serveur MCP plutôt que par des appels REST directs, mais la spécification complète est disponible pour les outils et les clients personnalisés.
Spécification OpenAPI
La spécification lisible par machine est servie en direct et reste synchronisée avec l'API déployée. Ouvrez-la directement ou importez-la dans un outil comme Scalar, Redoc, Postman ou Insomnia :
Ouvrir openapi.jsonLa spécification est également annoncée pour les agents et les crawlers via /.well-known/api-catalog.
URL de base et gestion des versions
Chaque point de terminaison se trouve sous /api/v1 sur l'hôte API ; le préfixe de chemin porte la version.
Authentification
Les requêtes portent un jeton bearer. Les sessions navigateur utilisent un jeton d'accès de courte durée émis depuis un cookie de rafraîchissement HttpOnly ; l'accès MCP programmatique utilise OAuth 2.1, qui gère l'émission et le renouvellement des jetons pour vous.
Domaines de ressources
L'API couvre l'ensemble du domaine Strata. Les principaux domaines de ressources :
- Documents : CRUD, historique, commentaires, suggestions, accès, publication, images
- Spaces : membership, sources, autorisations d'accès, recherche hybride
- Entreprises, organisations et niveaux : la hiérarchie de l'espace de travail
- Utilisateurs et profils : comptes, memberships, profils publics
- Accès et partage : permissions, liens publics, autorisations Space
- Auth et OAuth : sessions, changement de tenant, clients MCP OAuth
- Agents et tâches : invocation d'agents de plateforme et utilisateur
- Administration et conformité : SSO, SCIM, audit, conservation, facturation
Générer un client
Pointez n'importe quel générateur de code OpenAPI 3.1 vers la spécification ci-dessus pour produire un client typé dans le langage de votre choix.
Vous préférez les outils aux appels REST directs ? Consultez la Référence des outils MCP.