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 ip-api.com já está no ar
O ip-api.com costuma ser o primeiro serviço de geolocalização de IP que um desenvolvedor procura, principalmente porque é rápido de testar e fácil de conectar a um script. É justamente essa simplicidade que nosso host compatível foi construído para preservar, enquanto funciona com um conjunto diferente de regras de cota e de preço.
O host reproduz exatamente o tratamento de requisições e o corpo de resposta do ip-api.com, exceto os textos de direitos autorais, termos e privacidade, que são nossos. Uma requisição que antes ia para o endpoint do ip-api.com pode vir para o nosso, e o JSON retornado é interpretado da mesma forma, com os mesmos nomes de campo nos mesmos lugares.
Como /v1/ip resolve completamente as duas famílias de endereços, este host compatível trata consultas IPv4 e IPv6 da mesma forma. Uma consulta de um endereço IPv4 e uma consulta de um endereço IPv6 voltam ambas no formato correto, sem nenhuma opção extra para dizer ao host que tipo de endereço ele está consultando.
As chaves se autenticam aqui da mesma forma que em todo o My Geocode: 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. Seja qual for o estilo que sua integração atual já usa, ele é aceito sem modificação.
Os preços neste host são os mesmos de todos os outros hosts e endpoints que operamos. Qualquer endereço recebe 2.500 consultas de IP gratuitas por dia sem chave nenhuma, contadas por rede. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia, separadas. Além disso, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês, sem acréscimo por usar um host compatível em vez de /v1/ip diretamente.
Os cabeçalhos de cota acompanham todas as respostas aqui também, algo que uma integração simples com o ip-api.com normalmente não expõe por conta própria: 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 estão todos incluídos.
Para projetos que querem mais do que uma consulta padrão, adicionar mg_extras=1 à requisição, ou enviar um cabeçalho X-MG-Extras, acrescenta campos opcionais, como detalhes de ameaça e de rede do IP, por cima da resposta compatível, sem alterar seu formato base a menos que você peça.
Os detalhes completos estão em /compatibility/ip-api/. Se algum script da sua stack já se comunica com o ip-api.com, redirecioná-lo para cá é uma forma rápida de ver a diferença que faz um host com controle de cota e preços em euros.