Documentation de l'API

IP et CIDR API de recherche

Interrogez la blocklist de Spike avec une seule requête GET authentifiée. Vérifiez n'importe quelle adresse IPv4/IPv6 ou plage CIDR et sachez si elle est listée, pourquoi et par quelle entrée.

1 · AUTHENTIFICATION

Chaque requête doit inclure votre clé d'API dans l'en-tête Authorization . Les clés se créent depuis votre tableau de bord Sendcorex.

  1. 1 Ouvrez Clés d'API dans votre tableau de bord et cliquez sur Nouvelle clé d'API.
  2. 2 Dans Autorisations, activez le spike:lookup .
  3. 3 Copiez la clé tout de suite. Elle n'est affichée qu'une seule fois.

2 · VÉRIFIER UNE IP OU UN CIDR

GEThttps://sec.sendcorex.com/check

En-têtes

Authorization Votre clé d'API. OBLIGATOIRE

Paramètres de requête

ipstring Une adresse IPv4 ou IPv6 (ex. 102.223.92.101) ou une plage CIDR (ex. 45.142.0.0/16). OBLIGATOIRE

3 · EXEMPLE DE REQUÊTE

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

4 · RÉPONSE

{
  "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
}

Champs de la réponse

ipstringLa valeur recherchée, renvoyée telle quelle.
query_type"ip" | "network"Si la recherche portait sur une seule adresse ou sur une plage CIDR.
blockedbooleantrue quand l'adresse ou le réseau figure dans la blocklist de Spike.
listed_as"ip" | "network"Comment la correspondance est listée : en tant qu'adresse individuelle ou en tant que partie d'un réseau listé. Présent uniquement quand blocked vaut true.
matched_bystringL'entrée exacte qui a correspondu (ex. 102.223.92.101/32 ou 66.132.172.0/24). Présent uniquement quand blocked vaut true.
exactbooleantrue quand la valeur recherchée est elle-même listée ; false quand elle est seulement couverte par un réseau listé.
category"probe" | "scanner"probe : observée en train d'envoyer du trafic abusif ou malveillant. scanner : un scanner de recherche internet connu, pas une attaque confirmée. Présent uniquement quand blocked vaut true.
scanner_namestringNom du scanner (ex. Censys). Présent uniquement quand category vaut scanner.
messagestringUn résumé lisible du résultat.
is_ipv6booleantrue pour les recherches IPv6.

5 · INTERPRÉTER LES RÉSULTATS

category: probe

Observée en train d'envoyer du trafic abusif ou malveillant. Vous devriez refuser ses connexions ou traiter son trafic comme non fiable.

category: scanner

Un scanner de recherche connu qui sonde les ports sur internet. Il a été listé pour avoir sondé notre infrastructure, ce qui n'est pas une attaque confirmée. Le bloquer ou non, c'est votre choix.

exact: false

L'adresse n'est pas listée elle-même, mais elle appartient à un réseau listé. Vérifiez matched_by pour le réseau qui l'a causée.

blocked: false

Rien dans la blocklist ne correspond actuellement à l'adresse ou au réseau recherché.

Prêt à intégrer ?

Créez une clé avec la portée spike:lookup et faites votre première requête en quelques minutes.

Nous contacter