Watch-IP

Referência da API de Pesquisa de IP em Lote

POST/v1/lookup

Versão em lote de GET /v1/lookup/{ip} — resolve até 100 endereços IPv4/IPv6 num único pedido de back-end, devolvidos pela mesma ordem em que foram submetidos.

Autenticação

Forneça uma chave secreta através de Authorization: Bearer YOUR_SECRET_KEY, o mesmo tipo de chave do endpoint de pesquisa de um único IP.

Corpo do pedido

ips
Um array de 1 a 100 strings de endereços IPv4/IPv6. Todo o lote é validado antes de qualquer pesquisa ser executada — um endereço mal formado faz falhar a chamada inteira.

Erros

400
Um array ips vazio, mais de 100 IPs, ou um IP mal formado em qualquer parte do array.
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 \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Resposta

{
  "results": [
    { "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 },
    { "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
  ]
}

Limites

Cada IP do lote é faturado e registado individualmente — uma chamada com 100 IPs regista 100 eventos de utilização de pesquisa, não um. Um IP duplicado submetido duas vezes é faturado duas vezes. Para o limite de taxa por minuto, a chamada inteira conta como um único pedido. 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