REST-API

Strata basiert auf einer REST-API, die durch eine OpenAPI-3.1-Spezifikation beschrieben wird. Die meisten Integrationen verwenden den MCP-Server statt direkter REST-Aufrufe, aber die vollständige Spezifikation steht für Werkzeuge und benutzerdefinierte Clients zur Verfügung.

Spezifikation

OpenAPI-Spezifikation

Die maschinenlesbare Spezifikation wird live bereitgestellt und bleibt mit der bereitgestellten API synchron. Öffnen Sie sie direkt oder importieren Sie sie in einen Viewer wie Scalar, Redoc, Postman oder Insomnia:

openapi.json öffnen

Die Spezifikation wird für Agenten und Crawler auch über /.well-known/api-catalog bekanntgemacht.

Konventionen

Basis-URL und Versionierung

Jeder Endpunkt liegt unter /api/v1 auf dem API-Host; das Pfadpräfix trägt die Version.

Authentifizierung

Anfragen übertragen ein Bearer-Token. Browser-Sitzungen verwenden ein kurzlebiges Zugriffstoken, das aus einem HttpOnly-Refresh-Cookie erstellt wird; programmatischer MCP-Zugriff verwendet OAuth 2.1, das die Token-Ausstellung und -Erneuerung für Sie übernimmt.

Referenz

Ressourcenbereiche

Die API umfasst die gesamte Strata-Domäne. Die wichtigsten Ressourcenbereiche:

Dokumente: CRUD, Verlauf, Kommentare, Vorschläge, Zugriff, Veröffentlichung, Bilder
Spaces: Mitgliedschaft, Quellen, Zugriffsgenehmigungen, Hybridsuche
Unternehmen, Organisationen und Ebenen: die Arbeitsbereichs-Hierarchie
Benutzer und Profile: Konten, Mitgliedschaften, öffentliche Profile
Zugriff und Freigabe: Berechtigungen, öffentliche Links, Space-Genehmigungen
Authentifizierung und OAuth: Sitzungen, Mandantenwechsel, MCP-OAuth-Clients
Agenten und Aufgaben: Plattform- und Benutzer-Agenten-Aufruf
Verwaltung und Compliance: SSO, SCIM, Audit, Aufbewahrung, Abrechnung

Clients

Client generieren

Richten Sie einen beliebigen OpenAPI-3.1-Code-Generator auf die obige Spezifikation, um einen typisierten Client in der Sprache Ihrer Wahl zu erzeugen.

Bevorzugen Sie Tools gegenüber direkten REST-Aufrufen? Siehe die MCP-Werkzeugreferenz.