Limites de requisição

A API aplica um limite de requisições para proteger a plataforma.

O limite

• 1500 requisições por minuto, por endereço IP
• A janela é de 60 segundos

Esse limite é generoso para o uso normal, incluindo o polling de submissões e renders. Se você roda muitos processos a partir do mesmo IP, distribua as chamadas ao longo do tempo.

Quando o limite é atingido

Ao ultrapassar o limite, a API responde com:

• Status 429 Too Many Requests
• Header Retry-After com o número de segundos que você deve esperar
• Corpo: { "code": "RATE_LIMIT_EXCEEDED" }

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

{ "code": "RATE_LIMIT_EXCEEDED" }

Como lidar

• Respeite o Retry-After: espere o número de segundos indicado antes de tentar de novo
• Use backoff em caso de chamadas repetidas, em vez de tentar imediatamente
• Espace o polling: ao acompanhar uma submissão ou um render, consulte em intervalos de alguns segundos em vez de em loop apertado

Nota

A API não retorna headers X-RateLimit-*. Use o status 429 e o Retry-After para detectar e tratar o limite.