Documentación de la API
← Inicio

API REST de Digesto IA. Spec OpenAPI cruda en /openapi.json. Para probar interactivamente, usá la demo con login.

POST /login

Autentica usuario/contraseña contra el IdP interno y devuelve un token.

Body{"usuario":"...","password":"..."}
Respuesta{"access_token":"...","expires_in":300}

POST /query

Pregunta en lenguaje natural → respuesta citada (o abstención).

AuthBearer (rol admin/consultor/readonly)
Body{"pregunta":"..."}
Respuesta{"respuesta":"...","abstuvo":false,"fuentes":[{"documento":"...","pagina":6,"texto":"..."}]}

GET /health

Liveness: el proceso responde. No toca dependencias.

Respuesta{"status":"ok"}

GET /ready

Readiness: hay índice con documentos (503 si está vacío).

Respuesta{"status":"ready","chunks":727}

GET /metrics

Métricas Prometheus (protegible con RAG_METRICS_TOKEN).

GET /audit/tail

Últimas entradas del registro de auditoría (Art. 9).

AuthBearer (rol admin)