My Geocode

Substituto compatível (drop-in) do ip-api.com

O endpoint JSON do ip-api é um dos formatos de consulta de IP mais copiados. ipapi.mygeocode.com retorna os mesmos nomes de campo para endereços IPv4 e IPv6, por HTTPS também nas chaves gratuitas, algo que o ip-api não oferece.

Troque um nome de host

Host original
  • ip-api.com
  • pro.ip-api.com
Use no lugaripapi.mygeocode.com
Parâmetro da chavekey (opcional: qualquer endereço recebe 2.500 requisições por dia sem chave; coloque aqui sua chave do My Geocode para crédito, pacotes e histórico de uso)
Antes
curl "http://ip-api.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"
Depois
curl "https://ipapi.mygeocode.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"

Por que as pessoas migram

O endpoint gratuito do ip-api é só HTTP, não comercial e limitado a 45 requisições por minuto. Aqui é HTTPS, o uso comercial é permitido e qualquer endereço recebe 2.500 por dia antes de pagar qualquer coisa, com ou sem chave.

A mesma cota gratuita, com ou sem chave. As requisições para ipapi.mygeocode.com contam para as mesmas 2.500 requisições gratuitas por dia que o seu endereço, ou a sua chave, recebe nos nossos próprios endpoints. Acima disso, crédito pré-pago a € 0,0001 por requisição, ou € 50 por mês por uma chave Unlimited. Para se cadastrar, basta um endereço de e-mail.

Ver preços Obtenha uma chave grátis

Endpoints

Caminho em ipapi.mygeocode.comO que fazBaseado em
/json/{ip}Consulta por endereço, IPv4 ou IPv6Consulta de IPv4
/json/Consultar quem faz a chamadaConsulta de IPv4
/batch (POST, JSON array)Consulta em lote, até 100Consulta de IPv4

Exemplo de resposta

Isto é o que a requisição acima retorna. Nomes de campo, aninhamento e tipos seguem o ip-api. Só os dados por trás deles são nossos.

Resposta de ipapi.mygeocode.com
{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "CA",
  "regionName": "California",
  "city": "Mountain View",
  "zip": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "as": "AS15169 Google LLC",
  "query": "8.8.8.8"
}

Detalhes e diferenças

Nenhuma chave é necessária para as primeiras 2.500 requisições por dia. Para usar uma chave do My Geocode, coloque-a onde ficava a sua chave do ip-api.com: o parâmetro de consulta key. O cabeçalho X-API-Key, Authorization: Bearer e a autenticação HTTP Basic (a chave como nome de usuário) também funcionam em todos os hosts, então bibliotecas cliente que se autenticam do próprio jeito continuam funcionando sem mudanças.

As respostas trazem os campos que o ip-api.com retorna e nada mais, então uma resposta pode ser usada em código que já interpreta o ip-api.com. Nossos dados adicionais (altitude do terreno, ameaças e detalhes da rede) estão disponíveis sob solicitação: adicione mg_extras=1 à consulta ou envie X-MG-Extras: 1.

  • A resposta padrão é o próprio conjunto de campos do ip-api, na mesma ordem. fields aceita nomes ou a máscara de bits numérica, e lang traduz os nomes de países e continentes para de, es, pt-BR, fr, ja, zh-CN e ru.
  • Os formatos json, xml, csv e line funcionam todos.
  • Um endereço inválido responde HTTP 200 com status: fail, como o ip-api; só as recusas por chave e por cota mudam o código de status.
  • O endpoint de lote aceita até 100 entradas, com fields e lang por entrada, como o ip-api; cada endereço nele conta como uma requisição.
  • Peça reverse e o nome de host daquele endereço é resolvido.
  • Os nomes de regiões vêm como códigos curtos para os Estados Unidos, o Canadá e a Austrália; nos outros países, o conjunto de dados só tem o nome completo.

Se o seu cliente depende de um campo ou comportamento que não está listado aqui, avise-nos. Lacunas de compatibilidade são corrigidas rapidamente porque costumam ser pequenas.

Outros hosts compatíveis

Como funcionam os hosts compatíveis, a visão geral e os substitutos para bibliotecas JavaScript.