跳转至

WAF3.0 API

POST 更新防篡改规则

POST /prod-api/waf/wafv3/falsify/modifyFalsifyRule

为指定域名 新增 或 编辑 防篡改路径规则(受保护页面全路径)。规则列表见 列出域名的防篡改规则

场景 falsifyRuleId
新增 不传
编辑 必传,取值 = 列表中的 locationId

Body 请求参数

新增规则:

{
  "domainId": 215,
  "name": "/root/index.jsp"
}

编辑规则:

{
  "domainId": 215,
  "name": "/root/index.jsp",
  "falsifyRuleId": 2680
}

Body 字段说明

字段 类型 必选 说明
domainId integer(int64) 域名 ID,来自 列出防篡改域名rows[].domainId
name string 受保护页面 全路径,以 / 开头(如 /root/index.jsp);需包含文件名及扩展名
falsifyRuleId integer(int64) 规则 ID;编辑时必填,与 列出域名的防篡改规则rows[].locationId 相同;新增时不要传此字段

新增时服务端会自动设置规则类型 type = 4source = falsifysort = 999,无需在请求中传递。

name 填写说明

  • 填写源站页面的完整路径,不是仅域名或目录名。
  • 控制台校验要求:以 / 开头,且路径末尾为带扩展名的文件(如 .jsp.html)。
  • 配置成功后,WAF 对首次访问该路径进行缓存;更新路径后建议调用 刷新防篡改规则缓存 同步缓存。

请求参数

名称 位置 类型 必选 中文名 说明
Authorization header string 鉴权 Bearer Token
body body object 请求体 见上文

返回示例

200 Response

{
  "msg": "成功",
  "code": 200
}

返回结果

状态码 状态码含义 说明
200 OK 成功
401 Unauthorized 未授权
403 Forbidden 无权限

返回数据结构

状态码 200

名称 类型 必选 中文名 说明
msg string 提示信息 如「成功」
code integer 状态码 200 表示成功
data object 数据 一般无业务字段