O ipinfo.io tem um estilo de resposta característico: um campo loc que combina latitude e longitude em uma única string separada por vírgula, em vez de dois números separados, e um campo org que junta o número do sistema autônomo e o nome da organização, algo como "AS15169 Google LLC" em uma só string. A autenticação é feita por token, e fora isso a resposta permanece compacta e quase toda plana, com campos como city, region, country e postal ao lado desses dois campos combinados.
Essa formatação em string combinada merece atenção específica, porque o código que interpreta loc dividindo a string na vírgula, ou interpreta org dividindo no primeiro espaço, faz um trabalho real que precisa continuar funcionando corretamente após uma migração. É exatamente o tipo de pequeno detalhe de parsing fácil de deixar passar até que uma requisição em produção retorne algo que a lógica de divisão não espera.
O host de compatibilidade com o ipinfo do My Geocode reproduz essa mesma estrutura compacta, incluindo a string combinada loc e a string org prefixada com o número AS, sendo o texto de copyright, termos e privacidade o único conteúdo diferente. A referência está em /compatibility/ipinfo/. A lógica de parsing construída em torno da divisão de loc e org deve continuar funcionando exatamente como foi escrita.
As consultas de IP são um dos endpoints em que resultados reais podem ser descritos diretamente, e não apenas o formato. Uma consulta para um determinado endereço retorna cidade, região, país, a string combinada de coordenadas e a string combinada de organização, ao vivo, e não servidas de um cache desatualizado, já que os dados de geolocalização de IP no My Geocode são mantidos atualizados com uma camada de cache que se renova, e não uma que fica desatualizada.
Detalhes da migração para planejar:
X-API-Key, cabeçalho Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consultamg_extras=1 ou um cabeçalho X-MG-Extras, sem quebrar os campos que o seu código já lêX-Quota-Used e X-Credits-Remaining, o que é útil se a sua integração atual acompanha o uso manualmentePreços: 2.500 requisições gratuitas por dia sem chave, mais 2.500 gratuitas por chave por dia contadas por rede e, depois, crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, com todos os endpoints, incluindo este host de compatibilidade, pelo mesmo preço. Para aplicações construídas em torno do formato compacto específico do ipinfo para logs, análises ou decisões de acesso, o objetivo desta migração é que o formato em si nunca precise mudar, apenas quem o serve.