My Geocode

Substituto compatível (drop-in) do ipstack

Os endpoints de consulta padrão e check do ipstack respondem em ipstack.mygeocode.com com os mesmos campos de nível superior e o mesmo objeto location, por HTTPS em todos os planos.

Troque um nome de host

Host original
  • api.ipstack.com
Use no lugaripstack.mygeocode.com
Parâmetro da chaveaccess_key (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://api.ipstack.com/8.8.8.8?access_key=YOUR_IPSTACK_KEY"
Depois
curl "https://ipstack.mygeocode.com/8.8.8.8?access_key=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

O plano gratuito do ipstack é só HTTP e limitado a 100 por mês. Aqui toda chave recebe 2.500 por dia por HTTPS.

A mesma cota gratuita, com ou sem chave. As requisições para ipstack.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 ipstack.mygeocode.comO que fazBaseado em
/{ip}Consulta padrãoConsulta de IPv4
/checkConsultar quem faz a chamadaConsulta de IPv4
/{ip},{ip},{ip}Consulta em massaConsulta de IPv4

Exemplo de resposta

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

Resposta de ipstack.mygeocode.com
{
  "ip": "8.8.8.8",
  "type": "ipv4",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code": "US",
  "country_name": "United States",
  "region_code": "CA",
  "region_name": "California",
  "city": "Mountain View",
  "zip": "94043",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "location": {
    "geoname_id": 5375480,
    "capital": "Washington D.C.",
    "languages": [ { "code": "en", "name": "English", "native": "English" } ],
    "country_flag": "https://www.mygeocode.com/assets/img/flags/us.svg",
    "country_flag_emoji": "🇺🇸",
    "country_flag_emoji_unicode": "U+1F1FA U+1F1F8",
    "calling_code": "1",
    "is_eu": false
  }
}

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 ipstack: o parâmetro de consulta access_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 ipstack retorna e nada mais, então uma resposta pode ser usada em código que já interpreta o ipstack. 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.

  • O bloco time_zone vem preenchido: id, hora local atual, deslocamento, abreviação e se o horário de verão está em vigor.
  • Uma chave ausente responde com o erro 101 missing_access_key, e uma chave errada com 101 invalid_access_key.
  • region_code é um código curto para os Estados Unidos, o Canadá e a Austrália; nos outros países, o conjunto de dados só tem o nome completo.
  • Consultas em massa aceitam até 50 endereços separados por vírgula, como o ipstack (mais do que isso responde 302 too_many_ips), e cada endereço conta como uma requisição, da mesma forma que o ipstack conta.
  • Campos que dependem de um conjunto de dados que ainda não licenciamos (geoname id, capital, idiomas, código de discagem) estão presentes e com valor null.

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.