Riferimento API

Riferimento REST API — autenticazione, endpoint delle missioni, polling dei risultati, rate limit e codici di errore.

Panoramica

L'API è basata su REST, restituisce JSON ed è crittografata E2E. Tutti gli endpoint richiedono autenticazione via Keycloak SSO (token bearer OAuth2). L'isolamento dei tenant è applicato a tutti i livelli.

Autenticazione

Tutte le richieste API richiedono un token Bearer ottenuto da Keycloak. Il token ha ambito tenant e scade dopo 1 ora. I token di aggiornamento sono forniti per sessioni di lunga durata.

Endpoint chiave

POST /api/missions — invia una nuova missione. GET /api/missions/:id — ottiene lo stato della missione. GET /api/brain/query — interroga il Brain/RAG. GET /api/hit — elenca le approvazioni HIT in sospeso. POST /api/hit/:id/approve — approva un elemento HIT.

Esempi di codice

Consulta il riferimento API per esempi curl, Python e JavaScript. Il protocollo MCP consente la scoperta e l'esecuzione diretta di strumenti da qualsiasi client compatibile MCP.

Limiti di frequenza

I limiti di frequenza sono per tenant e per livello. Starter: 100 req/min. Business: 500 req/min. Professional: 2.000 req/min. Enterprise: personalizzato. Tutti i limiti sono espandibili fino a 2x per 10 secondi.