Documentación de la API

IP y CIDR API de consulta

Consulta la blocklist de Spike con una sola solicitud GET autenticada. Consulta cualquier dirección IPv4/IPv6 o rango CIDR y obtén si está listada, por qué y por qué entrada.

1 · AUTENTICACIÓN

Cada solicitud debe incluir tu clave de API en la cabecera Authorization . Las claves se crean desde tu panel de Sendcorex.

  1. 1 Abre Claves de API en tu panel y haz clic en Nueva clave de API.
  2. 2 En Permisos, activa el spike:lookup .
  3. 3 Copia la clave enseguida. Solo se muestra una vez.

2 · CONSULTA UNA IP O CIDR

GEThttps://sec.sendcorex.com/check

Cabeceras

Authorization Tu clave de API. OBLIGATORIO

Parámetros de consulta

ipstring Una dirección IPv4 o IPv6 (p. ej., 102.223.92.101) o un rango CIDR (p. ej., 45.142.0.0/16). OBLIGATORIO

3 · EJEMPLO DE SOLICITUD

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

4 · RESPUESTA

{
  "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 de la respuesta

ipstringEl valor consultado, devuelto tal cual.
query_type"ip" | "network"Si la consulta fue una sola dirección o un rango CIDR.
blockedbooleantrue cuando la dirección o red está en la blocklist de Spike.
listed_as"ip" | "network"Cómo está listada la coincidencia: como dirección individual o como parte de una red listada. Solo aparece cuando blocked es true.
matched_bystringLa entrada exacta que coincidió (p. ej., 102.223.92.101/32 o 66.132.172.0/24). Solo aparece cuando blocked es true.
exactbooleantrue cuando el propio valor consultado está listado; false cuando solo está cubierto por una red listada.
category"probe" | "scanner"probe: se observó enviando tráfico abusivo o malicioso. scanner: un escáner de investigación de internet conocido, no un ataque confirmado. Solo aparece cuando blocked es true.
scanner_namestringNombre del escáner (p. ej., Censys). Solo aparece cuando category es scanner.
messagestringUn resumen legible del resultado.
is_ipv6booleantrue para consultas IPv6.

5 · CÓMO INTERPRETAR LOS RESULTADOS

category: probe

Se ha observado enviando tráfico abusivo o malicioso. Deberías rechazar sus conexiones o tratar su tráfico como no confiable.

category: scanner

Un escáner de investigación conocido que sondea puertos en internet. Se listó por sondear nuestra infraestructura, lo que no es un ataque confirmado. Bloquearlo o no es tu decisión.

exact: false

La dirección no está listada por sí sola, pero pertenece a una red listada. Revisa matched_by de la red que lo causó.

blocked: false

Nada en la blocklist coincide ahora mismo con la dirección o red consultada.

¿Listo para integrar?

Crea una clave con el permiso spike:lookup y haz tu primera solicitud en minutos.

Contáctanos