Pesquise endereços IP em lotes
Envie uma lista de endereços IP para um único endpoint e receba uma lista correspondente de resultados de localização. A API de pesquisa de IP em lote do Watch-IP aceita até 100 endereços IPv4 e IPv6 por pedido, para fluxos de trabalho de enriquecimento no back-end. Mantenha a sua chave secreta no servidor, processe a resposta pela ordem de entrada, e trate os registos em falta sem perder a ligação aos seus dados originais.
Um pedido, até 100 endereços
Utilize POST /v1/lookup com um objeto JSON que contém um array ips. Cada lote aceite contém pelo menos um endereço e no máximo 100, e pode combinar endereços IPv4 e IPv6 válidos na mesma lista. A resposta envolve os resultados de pesquisa ordenados num array results; cada resultado utiliza a estrutura de pesquisa de um único IP, incluindo found e campos de localização que podem ser nulos.
Mantenha os resultados alinhados com os seus registos de origem
Para um lote bem-sucedido, a API devolve um resultado para cada endereço de entrada, pela mesma ordem. Mantenha os seus próprios identificadores de registo junto com a lista submetida, para poder associar os resultados às suas linhas originais. Quando um registo não é encontrado, preserve a linha e marque a localização como indisponível; quando apenas um campo está em falta, mantenha o restante do resultado. Não substitua coordenadas em falta por zero, o que transformaria a ausência de dados numa localização de mapa enganosa.
Valide antes de submeter
Uma lista vazia, uma lista com mais de 100 endereços, ou um IP mal formado produz um erro de pedido — um endereço mal formado rejeita o lote inteiro, em vez de produzir um resultado de sucesso parcial para as restantes entradas. Valide a entrada e divida listas mais longas em lotes antes de as enviar, e mantenha um registo dos lotes concluídos, para que uma nova tentativa não repita acidentalmente um trabalho inteiro.
Compreenda o que o agrupamento em lote altera
O agrupamento em lote reduz o número de pedidos HTTP necessários para submeter uma lista. Não altera a fonte de dados, não acrescenta campos de segurança, nem transforma 100 pesquisas numa única unidade de utilização — a utilização de pesquisa é registada por IP submetido em pedidos aceites, pelo que a escolha do plano deve ter em conta tanto o volume total de pesquisas como a taxa de pedidos. O limite de taxa por minuto conta chamadas HTTP, não itens: um lote de até 100 IP ou endereços de e-mail conta como um único pedido, enquanto cada item continua a contar separadamente para o limite mensal de pedidos.
Estrutura do pedido e da resposta
- ips
- Corpo do pedido: um array JSON de 1 a 100 endereços IPv4 ou IPv6.
- results
- Resposta: um array ordenado com uma entrada por endereço de entrada, pela mesma ordem submetida.
- results[].found, results[].country, ...
- Cada resultado utiliza a mesma estrutura e nulidade da resposta de pesquisa de um único IP — consulte a página do produto de pesquisa de IP.
Envie um pedido em lote
cURL — POST /v1/lookup
curl --fail-with-body \
'https://api.watch-ip.com/v1/lookup' \
--header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
--header 'Content-Type: application/json' \
--data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'Estes endereços de demonstração não implicam valores de localização atuais específicos. Defina primeiro WATCH_IP_SECRET_KEY no ambiente do seu servidor.
Perguntas frequentes
Quantos endereços IP cabem num lote?
O máximo atual é 100. Divida listas mais longas em pedidos que contenham cada um entre 1 e 100 endereços.
Um lote pode conter IPv4 e IPv6 ao mesmo tempo?
Sim. Todos os endereços têm de ser válidos, e a cobertura da base de dados pode diferir consoante o endereço.
Os resultados são devolvidos pela ordem de entrada?
Sim. Um lote aceite e bem-sucedido devolve um resultado por endereço de entrada, pela mesma ordem.
O que acontece se um IP estiver mal formado?
O pedido inteiro é rejeitado. Valide a sua entrada antes de submeter — este endpoint não fornece sucesso parcial para entradas mal formadas.
Um lote é faturado como uma única pesquisa?
Não. A utilização é medida por IP. Reveja os preços de pesquisa atuais e exemplos de faturação verificados antes de estimar o custo de um trabalho de grande volume.
Posso carregar um ficheiro CSV?
O endpoint documentado aceita um array JSON de endereços. A sua aplicação pode ler o seu próprio CSV e submeter lotes; uma interface de carregamento de CSV alojada não faz parte desta API.
A pesquisa em lote inclui verificações de VPN ou Tor?
Não. A atual resposta em lote é o resultado de localização da base de dados de geolocalização de terceiros. Os indicadores de segurança da geolocalização do visitante são uma funcionalidade separada, não presente nas respostas de pesquisa.