WAF3.0 API¶
POST 发起智能报告分析¶
POST /prod-api/waf/wafv3/intelligenceReport/start
按指定 WAF 日志时间范围 异步创建一条智能防护报告任务。服务端会汇总该时段内的攻击统计并调用 AI 生成报告；任务创建后立即返回 taskId，可通过 防护报告列表 查看进度，成功后用 智能报告详情 查看内容。
Body 请求参数
Body 字段说明¶
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
startTime |
string | 是 | 报告统计 开始 时间，格式 yyyy-MM-dd HH:mm:ss |
endTime |
string | 是 | 报告统计 结束 时间，格式 yyyy-MM-dd HH:mm:ss |
时间范围约束¶
| 规则 | 说明 |
|---|---|
| 格式 | yyyy-MM-dd HH:mm:ss，如 2026-05-13 00:00:00 |
| 顺序 | endTime 不得早于 startTime |
| 跨度 | 最长 1 个月（31 天），超出返回「时间范围最长支持1个月」 |
| 必填 | 缺少任一时间返回「请选择时间范围」 |
该时间段对应历史列表中的
reportStartTime、reportEndTime、reportLabel（如2026-05-13 00:00:00 ~ 2026-05-20 00:00:00）。
其它业务规则¶
- 同一用户、相同
startTime+endTime且状态为RUNNING的任务已存在时，直接返回该进行中的任务，不重复创建。 - 每账号每日创建次数有限制（默认最多 20 次，以服务端配置为准）。
- 报告在后台异步生成，初始状态为
PENDING，随后变为RUNNING，最终为SUCCESS或FAILED。
请求参数¶
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| Authorization | header | string | 是 | 鉴权 | Bearer Token |
| body | body | object | 是 | 请求体 | 见上文 |
返回示例
200 Response
{
"msg": "成功",
"code": 200,
"data": {
"taskId": "31fa09027a0c467c827c66430a81538c",
"taskStatus": "PENDING",
"errorMessage": null,
"createTime": "2026-05-20 10:00:00",
"startTime": "2026-05-20 10:00:00",
"finishTime": null,
"reportStartTime": "2026-05-13 00:00:00",
"reportEndTime": "2026-05-20 00:00:00",
"reportLabel": "2026-05-13 00:00:00 ~ 2026-05-20 00:00:00",
"summary": null,
"riskLevel": null
}
}
返回结果¶
| 状态码 | 状态码含义 | 说明 |
|---|---|---|
| 200 | OK | 任务已创建（或返回已存在的进行中任务） |
| 401 | Unauthorized | 未授权 |
| 403 | Forbidden | 无权限 |
返回数据结构¶
状态码 200
| 名称 | 类型 | 说明 |
|---|---|---|
code |
integer | 200 表示成功 |
msg |
string | 提示信息 |
data |
object | 新建（或进行中的）任务信息，字段与 history 的 rows[] 一致 |
data 主要字段¶
| 字段 | 说明 |
|---|---|
taskId |
任务 ID，后续查询详情、删除、导出 PDF 均使用 |
taskStatus |
创建后一般为 PENDING，生成中为 RUNNING |
reportStartTime |
与请求的 startTime 一致 |
reportEndTime |
与请求的 endTime 一致 |
reportLabel |
时间范围展示文案 |
summary / riskLevel |
生成完成前多为 null，SUCCESS 后才有值 |