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 ipinfo.io já está no ar
O ipinfo.io é uma escolha comum para equipes que só precisam responder rapidamente a uma pergunta: onde está este endereço IP e a qual rede ele pertence. Como a integração costuma ser pequena, uma única função envolvendo uma chamada HTTP, ela muitas vezes fica intocada por anos, mesmo quando a equipe está disposta a comparar opções em outras áreas. Nosso host compatível torna fácil redirecionar essa pequena integração.
Aponte para o nosso host uma requisição que antes ia para o ipinfo.io, e a resposta volta no mesmo formato, campo por campo, exceto os textos de direitos autorais, termos e privacidade, que são nossos. Se seu código lê um corpo JSON em busca de país, região, cidade, coordenadas ou informações de organização, ele continua lendo os mesmos campos nos mesmos lugares.
Como /v1/ip resolve completamente endereços IPv4 e IPv6, o host compatível também resolve. Uma consulta de um endereço como 8.8.8.8 retorna imediatamente campos de localização e de rede no formato esperado, sem nenhuma configuração separada para qualquer das duas famílias de endereços.
A autenticação funciona como em todos os hosts do My Geocode: cabeçalho X-API-Key, cabeçalho Authorization: Bearer, HTTP Basic auth com a chave como nome de usuário ou parâmetro de consulta. Use a forma que sua integração atual com o ipinfo.io já envia, já que as quatro também são aceitas aqui.
A estrutura de preços por trás é a nossa, e é consistente em toda a plataforma. Qualquer endereço recebe 2.500 consultas gratuitas por dia sem chave nenhuma, contadas por rede, para que uma conexão compartilhada não seja dividida entre várias chaves para multiplicar essa cota. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia. Além dessas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre o uso por € 50 por mês, sem valor separado para este host em relação a qualquer outro.
Toda resposta traz nossos cabeçalhos de cota, oferecendo um nível de visibilidade do uso diário que uma integração simples com o ipinfo.io não exporia: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining estão presentes em todas as chamadas.
Se você quer mais do que a resposta de IP padrão, adicionar mg_extras=1 à requisição ou um cabeçalho X-MG-Extras acrescenta extras opcionais, como detalhes de ameaça e de rede do IP, por cima do formato compatível, apenas se você escolher. Deixe desligado e a resposta corresponde exatamente ao formato do ipinfo.io.
O host está documentado em /compatibility/ipinfo/, e o comportamento da consulta de IP por trás dele é explicado em detalhes em /docs/ipv4-lookup/ e /docs/ipv6-lookup/.