Substituto compatível (drop-in) do ipinfo.io

O JSON compacto do ipinfo, com uma string loc e uma string org prefixada pelo número AS, é reproduzido em ipinfo.mygeocode.com. As bibliotecas cliente oficiais do ipinfo aceitam uma URL base personalizada, então elas também funcionam.

Troque um nome de host

Host original	`ipinfo.io`
Use no lugar	`ipinfo.mygeocode.com`
Parâmetro da chave	`token` (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 "https://ipinfo.io/8.8.8.8/json?token=YOUR_IPINFO_TOKEN"

Depois

curl "https://ipinfo.mygeocode.com/8.8.8.8/json?token=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

O plano gratuito do ipinfo é de 50.000 por mês, sem detalhes de geolocalização em alguns campos. Aqui toda chave recebe 2.500 por dia com todos os campos, e o uso pago é por requisição ou com valor fixo.

A mesma cota gratuita, com ou sem chave. As requisições para ipinfo.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 ipinfo.mygeocode.com	O que faz	Baseado em
`/{ip}/json`	Consulta por endereço	Consulta de IPv4
`/{ip}`	Consulta por endereço (mesma resposta)	Consulta de IPv4
`/json`	Consultar quem faz a chamada	Consulta de IPv4
`/{ip}/{field}`	Campo único, texto simples (city, country, loc, org, timezone)	Consulta de IPv4

Exemplo de resposta

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

Resposta de ipinfo.mygeocode.com

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "org": "AS15169 Google LLC",
  "postal": "94043",
  "timezone": "America/Los_Angeles"
}

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 ipinfo.io: o parâmetro de consulta token, um token Bearer ou curl -u YOUR_KEY:, como nos próprios exemplos do ipinfo. 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 ipinfo.io retorna e nada mais, então uma resposta pode ser usada em código que já interpreta o ipinfo.io. 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.

hostname vem de uma consulta de DNS reverso e é omitido quando o endereço não tem registro PTR, exatamente como o ipinfo faz.
anycast aparece quando o endereço é anycast, e faixas reservadas respondem bogon.
Um endereço inválido responde 404 com o corpo "Wrong ip" do ipinfo.
O campo readme nunca aparece, porque toda requisição aqui é autenticada.
Os endpoints de campo único (/8.8.8.8/city e semelhantes) retornam texto simples.
POST /batch funciona como o do ipinfo: um array JSON de até 1.000 endereços, caminhos address/field ou URLs completas responde com um objeto indexado por cada entrada, filter=1 remove as vazias e cada entrada conta como uma consulta, da mesma forma que o ipinfo conta. Um lote maior do que o que resta da cota do dia é recusado por inteiro com o 429 do ipinfo, em vez de ser respondido em parte.

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.