Integrationen

Edge-Prüfungen

Ein Aufruf pro Besucher von Ihrem Edge aus, dazu die Richtlinie, die Ihr Worker durchsetzt.

Besucher prüfen

POST/v1/edge/check

API-SchlüsselZählt als 2 Anfragen

Parameter

ipstringErforderlich
Client-IP, wie Ihre Edge sie sieht.
sitestring
Ihre Website-ID aus dem Dashboard. Ohne sie enthält die Antwort keine Website.
user_agentstring
User-Agent-Header der Anfrage.
ja4string
JA4-TLS-Fingerprint des Clients.
headersobject
Anfrage-Header, für die Konsistenzprüfung.
headless_flagsobject
Im Browser gesammelte Automatisierungsmerkmale, etwa webdriver.
request_idstring
Ihre eigene ID für die Anfrage, wird mit dem Urteil gespeichert.

Antwortfelder

classstring
verified_bot, malicious_automation, ai_agent, tor, vpn, proxy, relay, hosting oder human.
agentobject
Das Agentscan-Urteil: Klasse, Konfidenz, Aktion und Signale.
networkobject
networkClass, anonymized, riskScore, provider, vpnProvider, country, asn, asnName und evidence. provider und vpnProvider ab Starter, bei Free null.
network.vpnProviderstring | null
VPN-Dienst einer vpn-Adresse (NordVPN, Mullvad...), sofern bekannt. Ab Starter, bei Free null.
siteobject | null
ID, Modus und policyVersion Ihrer Website; null, wenn die Website unbekannt ist oder nicht Ihnen gehört.
lockedstring[]
Punktierte Pfade der Felder, die in diesem Tarif als null gesendet werden. Ab Starter nicht vorhanden.
planRequiredstring
Tarif, der die gesperrten Felder enthält. Ab Starter nicht vorhanden.

curl -X POST https://ipscanner.io/v1/edge/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "site_4fQ8nZ2kLm7xR1vT9cBw",
    "ip": "203.0.113.7",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 Safari/605.1.15",
    "ja4": "t13d1516h2_8daaf6152771_02713d6af862",
    "request_id": "8c1f2a3b4d5e6f70-AMS"
  }'

Antwort

{
  "class": "vpn",
  "agent": {
    "class": "human",
    "confidence": 0.6,
    "action": "allow",
    "signals": {
      "network_origin": "vpn",
      "anonymized": true,
      "headless": false
    }
  },
  "network": {
    "networkClass": "vpn",
    "anonymized": true,
    "riskScore": 90,
    "provider": "M247 Europe SRL",
    "vpnProvider": "NordVPN",
    "country": "NL",
    "asn": 9009,
    "asnName": "M247 Europe SRL",
    "evidence": [
      "vpn_server_list"
    ]
  },
  "site": {
    "id": "site_4fQ8nZ2kLm7xR1vT9cBw",
    "mode": "monitor",
    "policyVersion": 3
  }
}

Richtlinie einer Website lesen

GET/v1/sites/{id}/policy

API-SchlüsselNicht berechnet

Parameter

idstringPfadErforderlich
Website-ID, etwa site_4fQ8nZ2kLm7xR1vT9cBw.

Antwortfelder

sitestring
Die Website-ID.
modestring
monitor oder enforce.
policyobject
allow, flag oder block pro Verkehrsklasse. Eine fehlende Klasse bedeutet allow.
versioninteger
Steigt um eins, sobald sich Richtlinie oder Modus ändern.
updatedAtstring
Zeitpunkt der letzten Änderung der Website.

curl https://ipscanner.io/v1/sites/site_4fQ8nZ2kLm7xR1vT9cBw/policy \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwort

{
  "site": "site_4fQ8nZ2kLm7xR1vT9cBw",
  "mode": "enforce",
  "policy": {
    "malicious_automation": "block",
    "ai_agent": "flag",
    "verified_bot": "allow"
  },
  "version": 3,
  "updatedAt": "2026-10-08T09:30:00Z"
}