A API de Recuperação de Lista Negra de Endereços IP foi projetada para avaliar a reputação de um endereço IP por meio da consulta simultânea a várias listas negras reconhecidas. Seu principal objetivo é determinar se um endereço IP foi classificado como potencialmente arriscado devido a atividades suspeitas, abusos anteriores ou comportamentos associados a spam, malware ou acesso não autorizado. Esse tipo de API é essencial em ambientes onde a segurança e a confiabilidade do tráfego de rede são críticas.
O endpoint fornece um resumo claro do status do IP analisado, indicando se ele está listado em pelo menos uma lista negra, quantas listas foram consultadas e quantas correspondências foram detectadas. Além disso, oferece métricas adicionais, como o número de listas que responderam corretamente, aquelas que não tinham listas e possíveis tempos de espera durante a consulta. Essas informações permitem avaliar não apenas o risco potencial, mas também a cobertura e a confiabilidade da análise realizada.
Um dos aspectos mais valiosos da API é o detalhe de cada lista negra onde o IP está listado. Para cada correspondência, são incluídos dados como o nome da lista, o status do resultado, o motivo da listagem e parâmetros técnicos adicionais. Isso facilita auditorias, análises forenses e tomadas de decisões informadas, como aplicar bloqueios automáticos, sinalizar tráfego para revisão ou gerar alertas de segurança.
Consulte várias listas negras para avaliar a reputação de um IP retornando status de listagem correspondências detectadas e métricas de verificação
Verificação de Lista Negra - Recursos do endpoint
| Objeto | Descrição |
|---|---|
ip |
[Obrigatório] Enter an IP address. |
{"ip":"8.8.8.8","is_listed":true,"checked_blacklists":61,"listed_count":4,"timeout_count":0,"ok_count":57,"listed_blacklists":[{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0}],"timeouts":[],"checked_at":"2026-01-23T12:54:22Z","_cached":true,"_cache_key":"ipx_api:blacklist_check:8_8_8_8"}
curl --location --request GET 'https://zylalabs.com/api/11765/ip+address+blacklist+retrieval+api/22312/blacklist+verification?ip=8.8.8.8' --header 'Authorization: Bearer YOUR_API_KEY'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
O endpoint de Verificação de Lista Negra retorna dados sobre a reputação de um endereço IP, incluindo se ele está listado em listas negras, o número de listas negras verificadas e informações detalhadas sobre cada lista negra onde o IP está listado
Os campos principais na resposta incluem "ip" (o endereço IP consultado), "is_listed" (booleano que indica se o IP está na lista negra), "checked_blacklists" (total de listas negras consultadas), "listed_count" (número de listagens encontradas) e "listed_blacklists" (detalhes de cada correspondência na lista negra)
Os dados de resposta estão estruturados em formato JSON, com um objeto principal contendo campos de resumo e um array de "listas_negras_listadas" que fornece informações detalhadas para cada correspondência de lista negra, incluindo nome, status, razão e tempo de resposta
O endpoint fornece informações sobre se um IP está na lista negra, o número total de listas negras verificadas, a contagem de listagens e razões detalhadas para cada listagem, o que ajuda a avaliar o nível de risco do IP
A precisão dos dados é mantida consultando várias listas negras reconhecidas garantindo que as informações sejam provenientes de bancos de dados respeitáveis Atualizações e verificações regulares são realizadas para garantir a confiabilidade dos dados retornados
Casos de uso típicos incluem melhorar a segurança da rede identificando endereços IP potencialmente prejudiciais automatizando a filtragem de tráfego realizando análises forenses e gerando alertas para atividades suspeitas
Os usuários podem utilizar os dados retornados para tomar decisões informadas sobre o acesso à rede como aplicar bloqueios automáticos em IPs listados sinalizar tráfego para revisão ou ajustar protocolos de segurança com base na avaliação de risco fornecida
Os usuários podem esperar uma estrutura de resposta consistente com campos que indicam o status do IP o número de listas negras verificadas e listagens detalhadas Padrões comuns incluem múltiplas listagens para IPs conhecidos de spam ou maliciosos juntamente com tempos de resposta variados de diferentes listas negras
Nível de serviço:
100%
Tempo de resposta:
118ms
Nível de serviço:
100%
Tempo de resposta:
110ms
Nível de serviço:
100%
Tempo de resposta:
170ms
Nível de serviço:
100%
Tempo de resposta:
1.398ms
Nível de serviço:
100%
Tempo de resposta:
1.944ms
Nível de serviço:
100%
Tempo de resposta:
8.137ms
Nível de serviço:
100%
Tempo de resposta:
390ms
Nível de serviço:
100%
Tempo de resposta:
105ms
Nível de serviço:
100%
Tempo de resposta:
188ms
Nível de serviço:
100%
Tempo de resposta:
645ms
Nível de serviço:
100%
Tempo de resposta:
2.472ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
22ms
Nível de serviço:
100%
Tempo de resposta:
24ms