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 | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
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.
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.