Integraties

Edge-checks

Eén aanroep per bezoeker vanaf je edge, en het beleid dat je Worker afdwingt.

Een bezoeker checken

POST/v1/edge/check

API-sleutelTelt als 2 verzoeken

Parameters

ipstringVerplicht
Client-IP zoals je edge het ziet.
sitestring
Je site-id uit het dashboard. Zonder id bevat het antwoord geen site.
user_agentstring
User-Agent-header van het verzoek.
ja4string
JA4-TLS-fingerprint van de client.
headersobject
Verzoekheaders, voor de consistentiecheck.
headless_flagsobject
Automatiseringssignalen uit de browser, zoals webdriver.
request_idstring
Je eigen id voor het verzoek, bewaard bij het oordeel.

Antwoordvelden

classstring
verified_bot, malicious_automation, ai_agent, tor, vpn, proxy, relay, hosting of human.
agentobject
Het Agentscan-oordeel: klasse, zekerheid, actie en signalen.
networkobject
networkClass, anonymized, riskScore, provider, vpnProvider, country, asn, asnName en evidence. provider en vpnProvider vanaf Starter, null op Free.
network.vpnProviderstring | null
VPN-dienst van een vpn-adres (NordVPN, Mullvad...), indien bekend. Vanaf Starter, null op Free.
siteobject | null
Id, modus en policyVersion van je site; null als de site onbekend is of niet van jou.
lockedstring[]
Paden (met punten) van de velden die op dit abonnement als null worden verzonden. Ontbreekt vanaf Starter.
planRequiredstring
Abonnement dat de vergrendelde velden bevat. Ontbreekt vanaf Starter.

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

Antwoord

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

Het beleid van een site lezen

GET/v1/sites/{id}/policy

API-sleutelTelt niet mee

Parameters

idstringpadVerplicht
Site-id, zoals site_4fQ8nZ2kLm7xR1vT9cBw.

Antwoordvelden

sitestring
De site-id.
modestring
monitor of enforce.
policyobject
allow, flag of block per verkeersklasse. Een ontbrekende klasse betekent allow.
versioninteger
Gaat met één omhoog bij elke wijziging van beleid of modus.
updatedAtstring
Wanneer de site voor het laatst wijzigde.

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

Antwoord

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