整合

邊緣偵測

每位訪客從您的邊緣發出一次呼叫，以及您的 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"
}