API Referenz

REST-API-Referenz — Authentifizierung, Missions-Endpoints, Ergebnis-Polling, Rate Limits und Fehlercodes.

Uebersicht

Die API ist REST-basiert, liefert JSON, und ist E2E verschluesselt. Alle Endpunkte erfordern Authentifizierung via Keycloak SSO (OAuth2 Bearer Token). Tenant-Isolierung wird auf jeder Ebene erzwungen.

Authentifizierung

Alle API-Anforderungen erfordern ein Bearer-Token von Keycloak. Das Token ist tenant-scoped und laeuft nach 1 Stunde ab. Refresh-Tokens werden fuer langlaufende Sitzungen bereitgestellt.

Wichtigste Endpunkte

POST /api/missions — neue Mission einreichen. GET /api/missions/:id — Missions-Status abrufen. GET /api/brain/query — Brain/RAG abfragen. GET /api/hit — Liste ausstehender HIT-Genehmigungen. POST /api/hit/:id/approve — HIT-Element genehmigen.

Code-Beispiele

Siehe API-Referenz fuer curl, Python und JavaScript Beispiele. Das MCP-Protokoll ermoeglicht direkte Tool-Entdeckung und Ausfuehrung von jedem MCP-kompatiblen Client.

Rate-Limits

Rate-Limits sind pro-Tenant und paketbasiert. Starter: 100 req/min. Business: 500 req/min. Professional: 2.000 req/min. Enterprise: massgeschneidert. Alle Limits sind burstable bis zu 2x fuer 10 Sekunden.