Watch-IP

Referência da API de Pesquisa de IP

GET/v1/lookup/{ip}

Resolve um único endereço IPv4 ou IPv6 que fornecer, utilizando uma base de dados de geolocalização de IP de terceiros — uma fonte de dados e uma forma de resposta diferentes das de GET /v1/geo. Apenas servidor-a-servidor; chame-o a partir do seu back-end, nunca a partir de um navegador.

Autenticação

Forneça uma chave secreta através de Authorization: Bearer YOUR_SECRET_KEY. Ao contrário da chave publicável utilizada por GET /v1/geo, esta chave tem de permanecer no seu servidor — utilizar uma chave publicável aqui devolve 403.

Campos de resposta

ip
O endereço IP que forneceu, devolvido tal como foi recebido.
country, city, continent
Localização aproximada a partir da base de dados de origem, ou nulo quando indisponível.
region
Um código de subdivisão (por exemplo, "TX"), não um nome de região — uma forma diferente do campo region de GET /v1/geo.
postalCode, timezone
Não preenchidos pela atual base de dados de origem — sempre nulos.
latitude, longitude
Coordenadas aproximadas, ou nulo quando indisponíveis.
found
False quando o IP não tem qualquer registo correspondente ou a base de dados subjacente está temporariamente indisponível — os dois casos não são distinguidos neste campo.

Erros

400
O IP fornecido não é um endereço IPv4 ou IPv6 válido.
401
Chave de API em falta ou inválida.
403
Foi utilizada uma chave publicável em vez de uma chave secreta.
429
Limite de taxa excedido para a janela de um minuto atual.

Exemplo

Pedido

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Resposta

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "TX",
  "city": "Austin",
  "postalCode": null,
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": null,
  "found": true
}

Limites

Faturado por IP pesquisado, separadamente do volume de pedidos do seu plano de geo de visitante — consulte a página do produto de pesquisa de IP para preços e disponibilidade. Precisa de mais do que um IP por chamada? Utilize antes o endpoint em lote. Os dados de localização deste endpoint são fornecidos pela DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Páginas relacionadas