Documentação da API

IP e CIDR API de consulta

Consulte a blocklist do Spike com uma única requisição GET autenticada. Consulte qualquer endereço IPv4/IPv6 ou faixa CIDR e receba se está listado, por quê e por qual entrada.

1 · AUTENTICAÇÃO

Toda requisição precisa incluir sua chave de API no cabeçalho Authorization . As chaves são criadas no seu painel da Sendcorex.

  1. 1 Abra Chaves de API no seu painel e clique em Nova chave de API.
  2. 2 Em Permissões, ative o spike:lookup .
  3. 3 Copie a chave na hora. Ela só aparece uma vez.

2 · CONSULTE UM IP OU CIDR

GEThttps://sec.sendcorex.com/check

Cabeçalhos

Authorization Sua chave de API. OBRIGATÓRIO

Parâmetros de consulta

ipstring Um endereço IPv4 ou IPv6 (ex.: 102.223.92.101) ou uma faixa CIDR (ex.: 45.142.0.0/16). OBRIGATÓRIO

3 · EXEMPLO DE REQUISIÇÃO

curl "https://sec.sendcorex.com/check?ip=102.223.92.101" \
  -H "Authorization: YOUR_API_KEY"

4 · RESPOSTA

{
  "ip": "102.223.92.101",
  "query_type": "ip",
  "blocked": true,
  "listed_as": "ip",
  "matched_by": "102.223.92.101/32",
  "exact": true,
  "category": "probe",
  "message": "This IP address is listed.",
  "is_ipv6": false
}

Campos da resposta

ipstringO valor consultado, devolvido como veio.
query_type"ip" | "network"Se a consulta foi um único endereço ou uma faixa CIDR.
blockedbooleantrue quando o endereço ou a rede está na blocklist do Spike.
listed_as"ip" | "network"Como o resultado está listado: como endereço individual ou como parte de uma rede listada. Só aparece quando blocked é true.
matched_bystringA entrada exata que correspondeu (ex.: 102.223.92.101/32 ou 66.132.172.0/24). Só aparece quando blocked é true.
exactbooleantrue quando o próprio valor consultado está listado; false quando ele só está coberto por uma rede listada.
category"probe" | "scanner"probe: visto enviando tráfego abusivo ou malicioso. scanner: um scanner de pesquisa de internet conhecido, não um ataque confirmado. Só aparece quando blocked é true.
scanner_namestringNome do scanner (ex.: Censys). Só aparece quando category é scanner.
messagestringUm resumo legível do resultado.
is_ipv6booleantrue para consultas IPv6.

5 · COMO INTERPRETAR OS RESULTADOS

category: probe

Visto enviando tráfego abusivo ou malicioso. Você deve recusar conexões vindas dele ou tratar o tráfego como não confiável.

category: scanner

Um scanner de pesquisa conhecido que varre portas pela internet. Foi listado por sondar nossa infraestrutura, o que não é um ataque confirmado. Bloquear ou não é decisão sua.

exact: false

O endereço não está listado sozinho, mas pertence a uma rede listada. Veja matched_by da rede que causou a listagem.

blocked: false

Nada na blocklist corresponde ao endereço ou à rede consultada no momento.

Pronto para integrar?

Crie uma chave com o escopo spike:lookup e faça sua primeira requisição em minutos.

Fale conosco