Límites de solicitudes
La API aplica un límite de peticiones para proteger la plataforma.
El límite
Sección titulada «El límite»- 1500 peticiones por minuto, por dirección IP
- La ventana es de 60 segundos
Ese límite es generoso para el uso normal, incluido el polling de envíos y renders. Si ejecutas muchos procesos desde la misma IP, reparte las llamadas a lo largo del tiempo.
Cuando se alcanza el límite
Sección titulada «Cuando se alcanza el límite»Al superar el límite, la API responde con:
- Estado
429 Too Many Requests - Header
Retry-Aftercon el número de segundos que debes esperar - Cuerpo:
{ "code": "RATE_LIMIT_EXCEEDED" }
HTTP/1.1 429 Too Many RequestsRetry-After: 60
{ "code": "RATE_LIMIT_EXCEEDED" }Cómo tratarlo
Sección titulada «Cómo tratarlo»- Respeta el
Retry-After: espera los segundos indicados antes de reintentar - Usa backoff en llamadas repetidas, en lugar de reintentar de inmediato
- Espacia el polling: al seguir un envío o un render, consulta cada pocos segundos en vez de en bucle cerrado