docs: 更新文档以反映从域名到站点的术语变更

- 将“域名筛选”统一更新为“站点筛选”或“多站点管理”
- 更新管理后台API文档,明确支持通过siteId参数筛选数据
- 在站点隔离配置文档中新增管理后台API使用说明
- 更新数据统计文档,将按域名分类改为按站点分类
- 修正相关API参数说明,从domain参数改为siteId参数
This commit is contained in:
anghunk
2026-02-09 16:40:42 +08:00
parent 489d30e084
commit a698734df5
6 changed files with 71 additions and 15 deletions

View File

@@ -1,6 +1,6 @@
# 统计数据
统计数据接口用于获取评论统计、域名列表等数据看板相关信息。
统计数据接口用于获取评论统计、站点列表等数据看板相关信息。
所有接口都需要在请求头中携带 Bearer Token。
@@ -80,12 +80,12 @@ GET /admin/stats/comments
| `summary.approved` | number | 已通过评论数 |
| `summary.pending` | number | 待审核评论数 |
| `summary.rejected` | number | 已拒绝评论数 |
| `domains` | Array\<DomainStat\> | 按域名聚合的评论统计列表 |
| `domains[].domain` | string | 解析后的域名(如 `example.com` |
| `domains[].total` | number | 该域名下评论总数 |
| `domains[].approved` | number | 该域名下已通过评论数 |
| `domains[].pending` | number | 该域名下待审核评论数 |
| `domains[].rejected` | number | 该域名下已拒绝评论数 |
| `domains` | Array\<DomainStat\> | 按站点聚合的评论统计列表 |
| `domains[].domain` | string | 站点 ID`blog``docs``default` |
| `domains[].total` | number | 该站点下评论总数 |
| `domains[].approved` | number | 该站点下已通过评论数 |
| `domains[].pending` | number | 该站点下待审核评论数 |
| `domains[].rejected` | number | 该站点下已拒绝评论数 |
| `last7Days` | Array\<DailyStat\> | 最近 30 天的每日评论数(按自然日聚合) |
| `last7Days[].date` | string (YYYY-MM-DD) | 日期UTC 时间格式化后的自然日 |
| `last7Days[].total` | number | 当日评论总数 |