Muitas requisições foram enviadas na janela de tempo atual. A API impõe limites de requisições para garantir uso justo e estabilidade da plataforma.
HTTP Status: 429 Too Many Requests
| Código | Descrição |
|---|---|
rate_limit_exceeded | O limite de requisições foi excedido |
{
"type": "https://docs.dinie.com/errors/rate-limit-exceeded",
"title": "Too Many Requests",
"status": 429,
"detail": "Rate limit exceeded. Try again in 30 seconds.",
"code": "rate_limit_exceeded"
}Toda resposta da API inclui estes headers:
| Header | Descrição |
|---|---|
X-RateLimit-Limit | Número máximo de requisições permitidas na janela atual |
X-RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset | Timestamp Unix de quando a janela será reiniciada |
- Leia o header
X-RateLimit-Resete aguarde até esse momento antes de tentar novamente. - Implemente backoff exponencial na lógica de retentativa.
- Agrupe operações quando possível para reduzir o número de requisições individuais.
- Monitore o header
X-RateLimit-Remainingpara reduzir o ritmo proativamente antes de atingir o limite.
- Guia de Tratamento de Erros -- Padrões completos de tratamento de erros e exemplos de código