Demasiadas peticiones
La API devuelve "title": "TOO_MANY_REQUESTS"
Un error en la petición. Hay algo que cambiar antes de volver a mandarla.
Superaste el límite de peticiones. El contador va por credencial, no por dirección IP: si repartes la integración entre varios servidores, todos comparten el mismo cubo.
Cuánto esperar
La respuesta trae la cabecera estándar:
HTTP/1.1 429 Too Many RequestsRetry-After: 23Los límites
| Rutas | Límite |
|---|---|
| Todas, por omisión | 120 por minuto |
POST /v1/partner/users y POST /v1/partner/wallets |
60 por minuto |
POST /v1/partner/api-keys/rotate |
5 por hora |
Reintentar
Sí, esperando lo que diga Retry-After. Si la petición era un POST, reintenta con la misma
Idempotency-Key.
Un 429 se decide antes de ejecutar nada, así que no hay duplicado posible; mantener la clave te
protege igual si el reintento coincide con una respuesta que sí llegó a procesarse.
Límites de uso trae un ejemplo de reintento con espera creciente.
Códigos que aparecen con este estado
Programa contra el campo code, nunca contra detail: la redacción puede cambiar, el código no.
code | Qué significa |
|---|---|
RATE_LIMITED | Se superó el número de peticiones permitidas en la ventana actual |
Llegaste aquí desde el campo type de una respuesta de error. La guíaErrores explica el formato completo y qué hacer con cada campo.