API Referentie

REST API-referentie — authenticatie, missie-endpoints, resultaat-polling, rate limits en foutcodes.

Overzicht

De API is REST-gebaseerd, retourneert JSON, en is E2E versleuteld. Alle endpoints vereisen authenticatie via Keycloak SSO (OAuth2 bearer token). Tenant isolatie wordt op elk niveau afgedwongen.

Authenticatie

Alle API verzoeken vereisen een Bearer token verkregen van Keycloak. Het token is tenant-scoped en verloopt na 1 uur. Refresh tokens worden verstrekt voor langlopende sessies.

Belangrijkste endpoints

POST /api/missions — dien een nieuwe missie in. GET /api/missions/:id — haal missie status op. GET /api/brain/query — bevraag de Brain/RAG. GET /api/hit — lijst met wachtende HIT goedkeuringen. POST /api/hit/:id/approve — keur een HIT item goed.

Code voorbeelden

Zie de API referentie voor curl, Python, en JavaScript voorbeelden. Het MCP protocol maakt directe tool ontdekking en uitvoering mogelijk vanuit elke MCP-compatibele client.

Rate limits

Rate limits zijn per-tenant en op pakket gebaseerd. Starter: 100 req/min. Business: 500 req/min. Professional: 2.000 req/min. Enterprise: op maat. Alle limits zijn burstable tot 2x voor 10 seconden.