集成

边缘检测

每位访客从您的边缘发起一次调用，以及您的 Worker 执行的策略。

检测访客

POST/v1/edge/check

API 密钥计为 2 次请求

参数

ipstring必填
在您的边缘看到的客户端 IP。
sitestring
控制台中的站点 id。不提供时，响应中不含站点。
user_agentstring
请求的 User-Agent 请求头。
ja4string
客户端的 JA4 TLS 指纹。
headersobject
请求头，用于一致性检查。
headless_flagsobject
在浏览器中收集的自动化迹象，如 webdriver。
request_idstring
您为请求设定的 id，与判定一同保存。

响应字段

classstring
verified_bot、malicious_automation、ai_agent、tor、vpn、proxy、relay、hosting 或 human。
agentobject
Agentscan 判定：类别、置信度、操作和信号。
networkobject
networkClass、anonymized、riskScore、provider、vpnProvider、country、asn、asnName 和 evidence。provider 和 vpnProvider 仅 Starter 及以上方案提供，Free 方案为 null。
network.vpnProviderstring | null
vpn 地址所属的 VPN 服务（NordVPN、Mullvad 等），已知时返回。Starter 及以上方案提供，Free 方案为 null。
siteobject | null
您站点的 id、模式和 policyVersion；站点未知或不属于您时为 null。
lockedstring[]
在当前方案下以 null 返回的字段路径（以点分隔）。Starter 及以上方案不返回此字段。
planRequiredstring
包含被锁定字段的方案。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"
  }'

响应

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

读取站点策略

GET/v1/sites/{id}/policy

API 密钥不计入用量

参数

idstring路径必填
站点 id，例如 site_4fQ8nZ2kLm7xR1vT9cBw。

响应字段

sitestring
站点 id。
modestring
monitor 或 enforce。
policyobject
按流量类别设为 allow、flag 或 block。未列出的类别视为 allow。
versioninteger
策略或模式每变更一次加一。
updatedAtstring
站点最近一次变更的时间。

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

响应

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