## 上传扫描统计 (`upload-scan-stats`)

上传防护页顶部统计:今日扫描、拦截、超上限未扫的次数,以及扫不了的网站列表;仅管理员可看。

鉴权: 仅管理员 · 文档: https://www-demo.kuxitong.com/zh/docs/api/upload-scan-stats

### GET `/api/v2/upload-scan-stats`

获取上传扫描统计 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/upload-scan-stats" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

上传扫描统计对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `today_blocked` | integer |  | 今日被上传扫描命中并拦下的次数(不含超上限、超时、出错的拦截);日志库不可用为 null。 |
| `today_scanned` | integer |  | 今日扫描的上传请求数(一请求多文件计 1);日志库不可用为 null。 |
| `today_unscanned` | integer |  | 今日因超过单文件上限而未扫描的次数;日志库不可用为 null。 |
| `unscanned_sites` | UploadScanStatsSite[] |  | 扫不了的网站,按网站 id 升序,最多 200 条;全局未开时只回一条 reason=global_off 的汇总(site_id 为 0)。其后另附 WAF 被节点本机带外总开关关停的在线节点(reason=node_kill,site_id 为 0、name 为节点名,最多 200 条,不计入 unscanned_total);全局未开时不附。 |
| `unscanned_total` | integer |  | 扫不了的网站总数(不受 200 条上限影响);全局未开时为全部启用网站数。 |