跳转到主要内容
PUT
/
team
/
threat-protection
更新团队的威胁防护策略
curl --request PUT \
  --url https://api.firecrawl.dev/v2/team/threat-protection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "normal",
  "allowRequestOverrides": true,
  "blacklist": [
    "*.risky.example"
  ],
  "blockedTlds": [
    "zip"
  ],
  "failurePolicy": "closed",
  "riskScoreThreshold": 75,
  "whitelist": [
    "*.trusted.example"
  ]
}
'
{
  "data": {
    "allowRequestOverrides": true,
    "blacklist": [
      "*.risky.example"
    ],
    "blockedTlds": [
      "zip"
    ],
    "configured": true,
    "failurePolicy": "closed",
    "mode": "normal",
    "riskScoreThreshold": 75,
    "updatedAt": "2023-11-07T05:31:56Z",
    "whitelist": [
      "*.trusted.example"
    ]
  },
  "success": true
}
对贵组织的威胁防护策略进行全量更新。未指定的字段将重置为默认值。仅限团队管理员。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
mode
enum<string>
必填

威胁防护模式。off 禁用检查;normal 使用 Google Web Risk 检查域名(每扫描一个域名消耗 +2 额度)。

可用选项:
off,
normal
示例:

"normal"

allowRequestOverrides
boolean

单个请求是否可以传入 threatProtection 对象。为 false 时,此类请求会被拒绝,并返回 403。

示例:

true

blacklist
string[]

精确域名或通配模式(例如 *.example.com)将始终被封禁,无需调用分类器。

示例:
["*.risky.example"]
blockedTlds
string[]

要直接封禁的顶级域名,需使用小写且不带前导点。

示例:
["zip"]
failurePolicy
enum<string>

分类器不可达时的行为:closed 时封禁(默认值),open 时允许。

可用选项:
open,
closed
示例:

"closed"

riskScoreThreshold
integer

归一化分数(0-100)达到或超过该值时,分类器判定结果会被封禁。值越低,规则越严格。

必填范围: 0 <= x <= 100
示例:

75

whitelist
string[]

精确域名或通配模式将始终被允许,其优先级高于其他所有规则。

示例:
["*.trusted.example"]

响应

团队所属组织当前生效的威胁防护策略。

data
object
success
boolean
示例:

true