Limites de Taxa e Erros
Entenda os limites de taxa, headers de resposta e códigos de erro.
Limites de Taxa por Plano
| Plano | Limite Diário | Por Segundo |
|---|
| Gratis | 1,000 | 5 |
| Trader | 50,000 | 20 |
| Business | 500,000 | 50 |
Headers de Resposta
Cada resposta da API inclui headers de limite de taxa para que você possa acompanhar seu uso.
X-RateLimit-LimitNumero maximo de requisicoes permitido na janela atual.
X-RateLimit-RemainingRequisicoes restantes na janela atual.
X-RateLimit-ResetTimestamp Unix quando a janela de limite sera redefinida.
Melhores práticas
- •Armazene respostas em cache — Os dados de cards e preços não mudam a cada segundo. Armazene em cache por pelo menos 5 minutos.
- •Use pesquisas em lote — Busque até 20 cards por solicitação usando o parâmetro
ids em vez de chamadas individuais. - •Implemente backoff exponencial — Quando você atingir um 429, aguarde e tente novamente com atrasos crescentes (1s, 2s, 4s).
- •Monitore os headers de limite de taxa — Verifique
X-RateLimit-Remaining para diminuir proativamente antes de atingir os limites.