API
Timeouts y rate limits
Timeouts#
| Canal | Plazo de decisión | Cómo configurarlo |
|---|---|---|
whatsapp | 15 s, fijo | — |
woocommerce | 3,5 s por defecto | X-Validata-Deadline-Ms entre 1500 y 5500 |
Configura el timeout de tu cliente por encima del plazo del canal (por ejemplo, 20 s para WhatsApp). Si se vence el plazo, recibes 503 SERVICE_UNAVAILABLE y no se consume cupo; reintenta con la misma clave. La cabecera de plazo no se firma y solo puede acortar la espera.
Un Idempotency-Key en curso se considera abandonado tras 30 s.
Rate limits#
| Alcance | Límite (ventana de 1 minuto) |
|---|---|
| Por integración | 120 solicitudes |
| Por comercio (todas sus integraciones) | 600 solicitudes |
Al excederlo: 429 RATE_LIMITED con la cabecera Retry-After (segundos). Las solicitudes que tu integración ya vio rechazadas no consumen el tope del comercio. El readback también cuenta.