Intégrations

Vérifications edge

Un appel par visiteur depuis votre edge, et la politique qu'applique votre Worker.

Vérifier un visiteur

POST/v1/edge/check

Clé APICompte pour 2 requêtes

Paramètres

ipstringObligatoire
IP du client vue par votre edge.
sitestring
L'id de votre site, depuis le tableau de bord. Sans lui, la réponse n'a pas de site.
user_agentstring
En-tête User-Agent de la requête.
ja4string
Empreinte TLS JA4 du client.
headersobject
En-têtes de la requête, pour le contrôle de cohérence.
headless_flagsobject
Indices d'automatisation relevés dans le navigateur, par exemple webdriver.
request_idstring
Votre propre id pour la requête, conservé avec le verdict.

Champs de la réponse

classstring
verified_bot, malicious_automation, ai_agent, tor, vpn, proxy, relay, hosting ou human.
agentobject
Le verdict Agentscan : classe, confiance, action et signaux.
networkobject
networkClass, anonymized, riskScore, provider, vpnProvider, country, asn, asnName et evidence. provider et vpnProvider à partir de Starter, null sur Free.
network.vpnProviderstring | null
Service VPN d'une adresse vpn (NordVPN, Mullvad...), si connu. À partir de Starter, null sur Free.
siteobject | null
L'id, le mode et la policyVersion de votre site ; null si le site est inconnu ou ne vous appartient pas.
lockedstring[]
Chemins pointés des champs envoyés à null avec cette formule. Absent à partir de Starter.
planRequiredstring
Formule qui inclut les champs verrouillés. Absent à partir de 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"
  }'

Réponse

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

Lire la politique d'un site

GET/v1/sites/{id}/policy

Clé APINon décompté

Paramètres

idstringcheminObligatoire
Id du site, par exemple site_4fQ8nZ2kLm7xR1vT9cBw.

Champs de la réponse

sitestring
L'id du site.
modestring
monitor ou enforce.
policyobject
allow, flag ou block par classe de trafic. Une classe absente vaut allow.
versioninteger
Augmente de un à chaque changement de politique ou de mode.
updatedAtstring
Dernière modification du site.

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

Réponse

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