WAF3.0 API¶
POST 更新防篡改规则¶
POST /prod-api/waf/wafv3/falsify/modifyFalsifyRule
为指定域名 新增 或 编辑 防篡改路径规则(受保护页面全路径)。规则列表见 列出域名的防篡改规则。
| 场景 | falsifyRuleId |
|---|---|
| 新增 | 不传 |
| 编辑 | 必传,取值 = 列表中的 locationId |
Body 请求参数
新增规则:
编辑规则:
Body 字段说明¶
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
domainId |
integer(int64) | 是 | 域名 ID,来自 列出防篡改域名 的 rows[].domainId |
name |
string | 是 | 受保护页面 全路径,以 / 开头(如 /root/index.jsp);需包含文件名及扩展名 |
falsifyRuleId |
integer(int64) | 否 | 规则 ID;编辑时必填,与 列出域名的防篡改规则 的 rows[].locationId 相同;新增时不要传此字段 |
新增时服务端会自动设置规则类型
type = 4、source = falsify、sort = 999,无需在请求中传递。
name 填写说明¶
- 填写源站页面的完整路径,不是仅域名或目录名。
- 控制台校验要求:以
/开头,且路径末尾为带扩展名的文件(如.jsp、.html)。 - 配置成功后,WAF 对首次访问该路径进行缓存;更新路径后建议调用 刷新防篡改规则缓存 同步缓存。
请求参数¶
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| Authorization | header | string | 是 | 鉴权 | Bearer Token |
| body | body | object | 是 | 请求体 | 见上文 |
返回示例
200 Response
返回结果¶
| 状态码 | 状态码含义 | 说明 |
|---|---|---|
| 200 | OK | 成功 |
| 401 | Unauthorized | 未授权 |
| 403 | Forbidden | 无权限 |
返回数据结构¶
状态码 200
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
msg |
string | 是 | 提示信息 | 如「成功」 |
code |
integer | 是 | 状态码 | 200 表示成功 |
data |
object | 否 | 数据 | 一般无业务字段 |