> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kairoconnect.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de la API

> Visión general de los endpoints de integración de Kairo Shield

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`.

## Endpoints de integración

| 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                     |

## Health checks (sin autenticación)

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

## Autenticación

Todas las rutas de integración requieren el encabezado `X-API-Key`. Consulte [Autenticación](/docs/shield/authentication).

## Formato de errores

Los errores siguen **RFC 7807** (Problem Details). Consulte [Errores frecuentes](/docs/shield/errors).