Limites de Taxa
Limites de taxa protegem a API de abusos e garantem uso justo para todos os clientes. Os limites variam por plano.
Limites por Plano
| Plano | Requisições/min | Créditos/mês |
|---|---|---|
| Grátis | 5 | 1.000 |
| Pague Conforme Usar | 5 | Baseado na compra |
| Projeto | 10 | 7.000 |
| Inicial | 10 | 28.000 |
| Startup | 10 | 85.000 |
| Crescimento | 10 | 200.000 |
Cabeçalhos de Limite de Taxa
Toda resposta da API inclui informações de limite de taxa nos cabeçalhos:
| Cabeçalho | Descrição |
|---|---|
X-RateLimit-Limit | Máximo de requisições por minuto para seu plano |
X-RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset | Timestamp Unix quando o limite de taxa é redefinido |
Lidando com Erros 429
Quando você excede o limite de taxa, a API retorna uma 429 Too Many Requests response. Para lidar com isso de forma elegante:
- Verifique o cabeçalho
X-RateLimit-Resetpara saber quando tentar novamente - Implemente backoff exponencial em sua lógica de nova tentativa
- Enfileire requisições para ficar dentro do limite por minuto
- Considere atualizar seu plano se você atingir limites consistentemente
429 Too Many Requests
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Retry after 30 seconds."
}
}Dicas
- Armazene em cache resultados quando possível para reduzir chamadas de API
- Agrupe consultas relacionadas em vez de fazer muitas requisições pequenas
- Monitore seu uso no painel para antecipar necessidades de limite