API REST
Strata è costruito su una API REST descritta da una specifica OpenAPI 3.1. La maggior parte delle integrazioni usa il server MCP anziché chiamare REST direttamente, ma la specifica completa resta disponibile per strumenti e client personalizzati.
Specifica OpenAPI
La specifica leggibile dalle macchine viene servita in tempo reale e resta allineata all'API in produzione. Aprila direttamente oppure importala in un visualizzatore come Scalar, Redoc, Postman o Insomnia:
Apri openapi.jsonLa specifica è inoltre annunciata ad agenti e crawler tramite /.well-known/api-catalog.
URL di base e versionamento
Tutti gli endpoint si trovano sotto /api/v1 sull'host dell'API; il prefisso del percorso indica la versione.
Autenticazione
Le richieste trasportano un bearer token. Le sessioni del browser usano un token di accesso di breve durata generato a partire da un cookie di refresh HttpOnly; l'accesso programmatico via MCP usa OAuth 2.1, che si occupa dell'emissione e del rinnovo dei token.
Aree di risorse
L'API copre l'intero dominio di Strata. Le principali aree di risorse:
- Documenti: CRUD, cronologia, commenti, suggerimenti, accessi, pubblicazione, immagini
- Spaces: appartenenza, fonti, concessioni di accesso, ricerca ibrida
- Aziende, organizzazioni e livelli: la gerarchia dell'area di lavoro
- Utenti e profili: account, appartenenze, profili pubblici
- Accesso e condivisione: autorizzazioni, link pubblici, concessioni sugli Spazi
- Autenticazione e OAuth: sessioni, cambio tenant, client OAuth MCP
- Agenti e attività: invocazione degli agenti di piattaforma e utente
- Amministrazione e conformità: SSO, SCIM, audit, conservazione, fatturazione
Genera un client
Punta un qualsiasi generatore di codice OpenAPI 3.1 alla specifica qui sopra per ottenere un client tipizzato nel linguaggio che preferisci.
Preferisci gli strumenti alle chiamate REST dirette? Consulta il riferimento agli strumenti MCP.