O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Limites de taxa explicados em linguagem simples
Os limites de taxa têm fama de ser confusos, cheios de exceções e letras miúdas que só ficam claras depois que algo quebra. Os nossos são mais simples do que isso, e vale a pena apresentá-los de forma clara em um só lugar.
Todo endereço recebe 2.500 requisições gratuitas por dia sem nenhuma chave. Essa cota não é individual por endereço, ela é compartilhada em uma rede: todos os endereços IPv4 do mesmo /24 e todos os endereços IPv6 do mesmo /48 consomem juntos de um único conjunto. Isso importa se você estiver atrás de uma conexão compartilhada de escritório ou de uma grande configuração de tradução de endereços de rede (NAT), já que a sua cota gratuita é compartilhada com todos os outros nesse mesmo segmento de rede, estejam eles usando uma chave ou não.
Cada chave também recebe a sua própria cota gratuita diária de 2.500 requisições, separada do que a rede já oferece. A cota de uma chave não é reduzida por outros tráfegos na mesma rede, e a cota de uma rede não é reduzida por tráfego que já esgotou a cota separada de uma chave. As duas cotas ficam lado a lado, em vez de competirem entre si.
Depois de esgotar as duas cotas em um determinado dia, uma requisição consome crédito pré-pago a € 0,0001 por requisição ou fica coberta por um pacote Unlimited a € 50 por mês, conforme o que a conta tiver configurado. Não há limitação que deixe as requisições silenciosamente mais lentas nem bloqueio surpresa sem explicação. Cada resposta traz cabeçalhos de cota, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit e X-Quota-Reset, para que a situação exata de uma requisição fique visível antes mesmo de ela falhar.
Uma chamada em massa ou em lote segue as mesmas regras no nível do item, e não no nível da chamada. Cem endereços enviados em uma única chamada contam como cem requisições na cota aplicável, exatamente como se tivessem sido enviados em cem chamadas separadas.
Tudo isso se aplica da mesma forma em todos os endpoints e em cada um dos dezessete hosts de compatibilidade. Uma requisição no formato do OpenCage ou do ipstack tem o limite de taxa definido exatamente pelas mesmas regras de uma requisição direta a /v1/forward ou /v1/ip, sem nenhum limite separado e mais rígido escondido atrás de um formato de resposta familiar.
Todos os detalhes, incluindo como funciona a reinicialização diária e o que cada cabeçalho significa, estão documentados em /docs/rate-limits/. Se alguma dúvida sobre limite de taxa surgir na sua integração, a resposta quase sempre está visível diretamente nos cabeçalhos da resposta que a provocou.