Referencia API

Referencia de la REST API — autenticación, endpoints de misiones, polling de resultados, límites de tasa y códigos de error.

Resumen

La API está basada en REST, devuelve JSON y está cifrada E2E. Todos los endpoints requieren autenticación vía Keycloak SSO (token bearer OAuth2). El aislamiento de inquilinos se aplica en todos los niveles.

Autenticación

Todas las solicitudes de API requieren un token Bearer obtenido de Keycloak. El token tiene alcance de inquilino y expira después de 1 hora. Se proporcionan tokens de actualización para sesiones de larga duración.

Endpoints clave

POST /api/missions — envía una nueva misión. GET /api/missions/:id — obtiene el estado de la misión. GET /api/brain/query — consulta el Brain/RAG. GET /api/hit — lista aprobaciones HIT pendientes. POST /api/hit/:id/approve — aprueba un elemento HIT.

Ejemplos de código

Consulta la referencia de API para ejemplos de curl, Python y JavaScript. El protocolo MCP permite el descubrimiento y ejecución directa de herramientas desde cualquier cliente compatible con MCP.

Límites de tasa

Los límites de tasa son por inquilino y por nivel. Starter: 100 req/min. Business: 500 req/min. Professional: 2.000 req/min. Enterprise: personalizado. Todos los límites son ampliables hasta 2x durante 10 segundos.