Referencia de la API

Esta referencia cubre los endpoints orientados a integradores fintech.

Base URL

Sustituya {BASE_URL} por la URL que le haya proporcionado Kairo Connect:

Entorno	Ejemplo
Staging	`https://staging-api.kairoshield.com`
Production	`https://api.kairoshield.com`

Todas las rutas de integración están bajo {BASE_URL}/api/v1.

Método	Ruta	Descripción
`POST`	`/score`	Scoring en tiempo real de una transacción
`POST`	`/score/batch`	Scoring por lote (hasta 1.000 transacciones)
`POST`	`/feedback`	Etiqueta confirmada de fraude o legítimo
`POST`	`/webhooks`	Registrar webhook
`GET`	`/webhooks`	Listar webhooks del cliente
`GET`	`/webhooks/{id}`	Obtener un webhook
`PUT`	`/webhooks/{id}`	Actualizar webhook
`DELETE`	`/webhooks/{id}`	Eliminar webhook
`GET`	`/webhooks/{id}/logs`	Historial de entregas
`POST`	`/webhooks/{id}/test`	Enviar payload de prueba

Método	Ruta	Uso
`GET`	`/health`	Liveness — el proceso está activo

Todas las rutas de integración requieren el encabezado X-API-Key. Consulte Autenticación.

Los errores siguen RFC 7807 (Problem Details). Consulte Errores frecuentes.