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.
Compatibilidade drop-in com o ipstack já está no ar
Muitos aplicativos recorrem à geolocalização de IP exatamente uma vez, no momento em que um usuário se conecta pela primeira vez, para adivinhar um país ou definir uma moeda padrão e seguir em frente. O ipstack há muito tempo é uma escolha comum para essa única etapa. Nosso novo host compatível permite que essa etapa continue funcionando da mesma forma, com outro backend.
O host espelha com precisão os parâmetros de requisição e o corpo de resposta do ipstack, exceto os textos de direitos autorais, termos e privacidade, que refletem o My Geocode e não o provedor original. Onde quer que seu aplicativo envie hoje uma consulta no formato do ipstack, ele pode enviar essa mesma consulta ao nosso host, e os campos retornados chegam nos mesmos lugares que seu código de interpretação atual espera.
As duas famílias de endereços têm suporte completo aqui, do mesmo modo que /v1/ip funciona em todo o restante da plataforma. Um endereço IPv4 e um endereço IPv6 são ambos resolvidos corretamente neste host, com o mesmo formato de resposta em qualquer caso.
As chaves podem ser enviadas como cabeçalho X-API-Key, como cabeçalho Authorization: Bearer, via HTTP Basic auth com a chave como nome de usuário ou como parâmetro de consulta, correspondendo ao padrão que sua integração atual com o ipstack já usa. As quatro formas são aceitas de maneira idêntica em todos os hosts e endpoints que operamos, então o código de autenticação raramente precisa mudar.
Os preços por trás deste host são os mesmos de todos os outros lugares. Qualquer endereço recebe 2.500 consultas gratuitas por dia sem precisar de chave, contadas por rede, para que um escritório ou prédio compartilhado use uma única reserva, e não várias. Uma chave adiciona, por si só, mais 2.500 requisições gratuitas por dia. Passadas essas cotas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês, sem valor separado para este host compatível.
Toda resposta também inclui nosso conjunto completo de cabeçalhos de cota, algo que uma integração simples com o ipstack não exporia: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining estão todos presentes, chamada após chamada.
Se seu projeto quer mais do que a resposta padrão, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta campos opcionais, como detalhes de ameaça e de rede do IP, por cima do formato compatível. Isso fica desligado por padrão, então nada muda no formato da resposta a menos que você peça especificamente.
O host compatível está documentado em /compatibility/ipstack/, e a referência completa de consulta de IP em /docs/ipv4-lookup/ e /docs/ipv6-lookup/ cobre tudo o que está por trás dele.