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

# Límites

> Ritmo, ráfagas, cuotas y qué pasa al superarlos.

| endpoint                  | por credencial                 | otros topes                                           |
| ------------------------- | ------------------------------ | ----------------------------------------------------- |
| `POST /v1/decisiones`     | 50/s sostenidas, ráfaga de 100 | cuota diaria del inquilino; 3 por `cliente_ref` y día |
| `POST /v1/eventos`        | 20/s                           | lotes de ≤ 1.000 eventos y ≤ 1 MB; cuota diaria       |
| `POST /v1/lotes-decision` | 1 en curso por inquilino       | ≤ 1 por hora                                          |
| `/ejecucion`              | 50/s                           | una confirmación por decisión; no después de 7 días   |

Al pasarte recibes `429 limite_excedido` con `Retry-After` en segundos. Espera
ese tiempo y reintenta con espera exponencial; el SDK lo hace solo y, tras varios
fallos, aplica el respaldo.

Las cuotas las fija el operador según tu contrato. Un uso anómalo (picos de 10×,
muchos errores, decisiones sin confirmar, recargas repetidas del histórico) activa
respuestas por escalones: aviso, freno (límites reducidos), cuarentena de los
eventos nuevos y, al final, suspensión de la credencial. Verás el aviso en la
consola antes de cualquier freno.