API-Dokumentation

IP und CIDR Abfrage-API

Frage die Spike-Blocklist mit einer einzigen authentifizierten GET-Anfrage ab. Prüfe jede IPv4/IPv6-Adresse oder jeden CIDR-Bereich und erfahre, ob sie gelistet ist, warum und durch welchen Eintrag.

1 · AUTHENTIFIZIERUNG

Jede Anfrage muss deinen API-Schlüssel im Header enthalten Authorization . Schlüssel erstellst du in deinem Sendcorex-Dashboard.

  1. 1 Öffne API-Schlüssel in deinem Dashboard und klicke auf Neuer API-Schlüssel.
  2. 2 Unter Berechtigungen, aktiviere den spike:lookup .
  3. 3 Kopiere den Schlüssel sofort. Er wird nur einmal angezeigt.

2 · EINE IP ODER EIN CIDR PRÜFEN

GEThttps://sec.sendcorex.com/check

Header

Authorization Dein API-Schlüssel. ERFORDERLICH

Query-Parameter

ipstring Eine IPv4- oder IPv6-Adresse (z. B. 102.223.92.101) oder ein CIDR-Bereich (z. B. 45.142.0.0/16). ERFORDERLICH

3 · BEISPIELANFRAGE

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

4 · ANTWORT

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

Antwortfelder

ipstringDer abgefragte Wert, unverändert zurückgegeben.
query_type"ip" | "network"Ob die Abfrage eine einzelne Adresse oder ein CIDR-Bereich war.
blockedbooleantrue, wenn die Adresse oder das Netzwerk in der Spike-Blocklist steht.
listed_as"ip" | "network"Wie der Treffer gelistet ist: als einzelne Adresse oder als Teil eines gelisteten Netzwerks. Nur vorhanden, wenn blocked true ist.
matched_bystringDer genaue Eintrag, der gepasst hat (z. B. 102.223.92.101/32 oder 66.132.172.0/24). Nur vorhanden, wenn blocked true ist.
exactbooleantrue, wenn der abgefragte Wert selbst gelistet ist; false, wenn er nur von einem gelisteten Netzwerk abgedeckt wird.
category"probe" | "scanner"probe: beim Senden von missbräuchlichem oder bösartigem Traffic beobachtet. scanner: ein bekannter Internet-Forschungsscanner, kein bestätigter Angriff. Nur vorhanden, wenn blocked true ist.
scanner_namestringName des Scanners (z. B. Censys). Nur vorhanden, wenn category scanner ist.
messagestringEine lesbare Zusammenfassung des Ergebnisses.
is_ipv6booleantrue bei IPv6-Abfragen.

5 · ERGEBNISSE INTERPRETIEREN

category: probe

Beim Senden von missbräuchlichem oder bösartigem Traffic beobachtet. Du solltest seine Verbindungen ablehnen oder seinen Traffic als nicht vertrauenswürdig behandeln.

category: scanner

Ein bekannter Forschungsscanner, der Ports im Internet abtastet. Er wurde gelistet, weil er unsere Infrastruktur abgetastet hat, was kein bestätigter Angriff ist. Ob du ihn blockierst, entscheidest du.

exact: false

Die Adresse ist nicht selbst gelistet, gehört aber zu einem gelisteten Netzwerk. Prüfe matched_by für das verursachende Netzwerk.

blocked: false

Derzeit passt nichts in der Blocklist zur abgefragten Adresse oder zum abgefragten Netzwerk.

Bereit für die Integration?

Erstelle einen Schlüssel mit dem Scope spike:lookup und sende deine erste Anfrage in wenigen Minuten.

Kontaktiere uns