Límites de solicitudes

La API aplica un límite de peticiones para proteger la plataforma.

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

Al superar el límite, la API responde con:

Estado 429 Too Many Requests
Header Retry-After con el número de segundos que debes esperar
Cuerpo: { "code": "RATE_LIMIT_EXCEEDED" }

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{ "code": "RATE_LIMIT_EXCEEDED" }

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