API Reference

Interfaces del ecosistema. Nada de secretos: solo contratos de interfaz.

MCP (agentes y forense)

• Endpoint JSON-RPC: /mcp (servidor drill-mcp-proxy) — ~55 herramientas, conformance verificada.
• Familias de herramientas: forense/evidencia, telemetría, kanban/economía, infra.
• DharmaGate actúa de escudo: valida identidad del agente y asienta PoI fail-closed (si no puede asentar on-chain, RECHAZA la operación).

REST de pagos (x402)

• GET /amenazas/... y endpoints de catálogo: sin pago responden HTTP 402 con challenge (headers x402).
• Con pago verificado (USDC en Base vía el facilitator) devuelven el recurso.
• Idempotencia por clave del challenge: misma clave + mismo payload = un único efecto; misma clave + payload distinto = rechazo.

Evidence API

• Servicio de evidencia con registro de auditoría (AUDIT JSON → pipeline de logs) — accesible tras pago/autenticación.

Autenticación

• Agentes: header HTTP propio o Basic Auth con tokens del grupo GitLab.
• Pagos: challenge x402 (ver Guía de uso).

Errores

• 402 = challenge de pago pendiente (es el flujo, no un error).
• 404 en la raíz de una API de pago = por diseño (la raíz no sirve nada).
• Errores JSON con message humano y code estable.

Límites y versionado

• Estado: PARTIAL — no hay versionado formal documentado de las APIs públicas todavía (PLANNED). Los cambios de contrato pasan por CI + revisión antes de producción.