Confira um endereço com o seu código postal
Detecte um endereço e um código postal que não batem antes de um pedido ser enviado, resolvendo cada um de forma independente e comparando o que eles realmente revelam.
Monitore o uso da sua chave antes de atingir um limite
Descobrir que você está perto do seu limite diário porque uma requisição acabou de ser rejeitada é a forma menos útil de descobrir. Cada resposta já traz os números necessários para ver isso chegando.
Os cabeçalhos a observar
X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00ZX-Quota-Free-Remaining diminuindo em direção a zero é o seu sinal antecipado mais claro para a cota diária gratuita. X-Credits-Remaining mostra quanta margem ainda resta depois que você passou da cota gratuita e está usando o crédito pré-pago a € 0,0001 por requisição.
Defina o seu próprio limite de alerta
Em vez de esperar por um 429, registre em log ou dispare um alerta quando X-Quota-Free-Remaining cair abaixo de um limite escolhido por você, como 10 por cento de X-Quota-Limit, para que haja tempo de reagir, seja desacelerando uma tarefa em lote, recarregando o crédito ou simplesmente esperando um período sem requisições até X-Quota-Reset.
Acompanhe também as vagas de IP da chave
X-Key-IPs-Used e X-Key-IPs-Limit acompanham quantos endereços de origem diferentes usaram uma determinada chave dentro da sua cota rotativa de vagas de IP. Uma chave usada de repente a partir de mais endereços do que o esperado, subindo em direção ao limite, merece ser investigada por si só, independentemente do volume de requisições, já que pode indicar uma chave sendo compartilhada mais amplamente do que o previsto.
Crie um painel simples
Um pequeno script que registra esses cabeçalhos em uma amostra das requisições, ou em todas elas se o volume for baixo o suficiente, mostra a tendência de uso ao longo do tempo sem precisar de uma chamada de monitoramento separada, já que os números chegam nas respostas que você já estava recebendo. Colocar X-Quota-Used em um gráfico ao longo de um dia ou de uma semana revela padrões de uso que um único instantâneo nunca mostraria.
Aja antes de bater no limite
Depois que você perceber um padrão consistente de operar perto do limite, os dois caminhos possíveis são as mesmas duas opções disponíveis a qualquer momento: adicionar crédito pré-pago para excedentes ocasionais ou passar para uma chave Unlimited a € 50 por mês se você ultrapassa a cota gratuita com frequência. Qualquer uma das decisões é mais fácil de tomar com calma, com antecedência, do que em resposta a um 429 bloqueando tráfego real.
Ler os cabeçalhos de cota como telemetria de rotina, e não só como algo a verificar quando uma requisição falha, transforma um limite rígido em uma tendência administrável. A cota atual e as opções de crédito estão na página de preços, e as definições completas dos cabeçalhos estão na documentação de limites de taxa.