Rate Limits
A API Pública aplica um limite de 60 requisições por minuto por API Key para garantir estabilidade e uso justo.
Limites atuais
| Limite | Valor |
|---|
| Requisições por minuto | 60 |
| Escopo do limite | Por API Key |
| Janela | Deslizante (sliding window) |
| Header | Descrição | Exemplo |
|---|
X-RateLimit-Limit | Limite máximo de requisições na janela | 60 |
X-RateLimit-Remaining | Requisições restantes na janela atual | 45 |
X-RateLimit-Reset | Timestamp Unix de quando o limite será resetado | 1711036800 |
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1711036800
{ ... }
Resposta quando o limite é excedido
Quando exceder o limite, a API retorna 429 Too Many Requests:
{
"detail": "Rate limit excedido. Tente novamente em alguns segundos."
}
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1711036860
Retry-After: 30
Boas práticas
Monitore os headers X-RateLimit-Remaining e Retry-After para evitar bloqueios desnecessários.
- Implemente retry com backoff exponencial: ao receber 429, aguarde o tempo indicado no header
Retry-After
- Cache respostas: dados que mudam pouco (produtos, recompensas) podem ser cacheados localmente
- Agrupe operações: em vez de consultar clientes um a um, use a listagem paginada
- Use webhooks quando disponível: para eventos em tempo real, prefira webhooks a polling
