Migração

Migrando do ipstack

O ipstack autentica com um parâmetro de consulta access_key e retorna uma resposta JSON com campos como type (ipv4 ou ipv6), continent_code, latitude, longitude e, nos planos superiores, um objeto aninhado connection com os detalhes de sistema autônomo e de ISP separados dos campos de nível superior. Essa estrutura aninhada de conexão é um pouco mais elaborada do que os formatos mais planos de alguns concorrentes, o que combina com aplicações que querem tratar os detalhes de ISP e de rede como um agrupamento lógico próprio, em vez de misturá-los aos campos de localização.

Migrar esse tipo de estrutura aninhada exige um pouco mais de cuidado do que uma resposta plana, simplesmente porque há mais pontos na árvore da resposta em que um nome de campo pode ser diferente. Vale a pena testar especificamente os caminhos aninhados, e não apenas os campos de nível superior, antes de considerar uma migração concluída.

O host de compatibilidade com o ipstack do My Geocode reproduz a estrutura completa, incluindo os campos type, continent_code, latitude, longitude e o objeto aninhado connection, alterando apenas o texto de copyright, termos e privacidade. Os detalhes de referência estão em /compatibility/ipstack/. O código que lê response.connection.isp ou response.type deve receber o mesmo formato depois de ser apontado para o novo host com uma nova chave.

Como as consultas de IP funcionam de ponta a ponta no My Geocode, os resultados aqui são concretos, e não descritos apenas pelo formato. Uma consulta para um determinado endereço retorna país, região, cidade, coordenadas e detalhes de conexão ao vivo, verificados em uma camada de cache que mantém a geolocalização de IP atualizada, em vez de depender de atualizações em lote pouco frequentes.

Observações específicas de migração para integrações com o ipstack:

  • O padrão do parâmetro de consulta access_key corresponde diretamente à nossa opção de parâmetro de consulta, ou você pode passar para um cabeçalho X-API-Key, Authorization: Bearer ou autenticação HTTP Basic durante a mesma migração, se preferir mudar o estilo de autenticação ao mesmo tempo
  • Os campos extras opcionais (altitude quando relevante, detalhes de ameaças de IP, informações de rede mais profundas) estão disponíveis via mg_extras=1 ou um cabeçalho X-MG-Extras, somando-se ao formato padrão em vez de substituir qualquer parte dele
  • Se a sua integração verifica os campos security para detecção de proxy ou de ameaças, esses valores específicos fazem parte dos extras opcionais e não da resposta de compatibilidade básica, então confirme de quais campos o seu código realmente depende antes de presumir paridade total

Quanto aos preços, 2.500 requisições por dia são gratuitas sem nenhuma chave, e cada chave recebe as próprias 2.500 requisições gratuitas por dia, contadas por rede. Além disso, o crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês se aplicam de forma uniforme, com todos os endpoints, incluindo este host compatível, pelo mesmo preço. Para aplicações que usam o objeto connection do ipstack como um agrupamento de dados próprio em seus modelos internos, esse agrupamento é mantido sem alterações, o que preserva o código downstream, os painéis e os data warehouses construídos sobre essa estrutura.