读取审核工作区待处理数量¶
请求参数与权限¶
无业务正文或必填查询参数。统计是全局待处理队列,列表的state、搜索、作者、页码等不会缩减这些数字。只返回计数,不返回正文、举报说明、收寄双方或其他用户资料。
OWNER和VIEWER持ADMIN_POSTS_READ均可读取;App Bearer不能授予后台权限。使用独立HttpOnly Cookie、可信HTTPS、同源和公共请求头。JSON遵循AES/JWE:GET空业务信封放X-Budyoo-JWE。请求无写操作,不要求CSRF写入令牌。
请求示例¶
变量由调用环境提供,REQUEST_JWE须绑定本次实际方法、路径、查询与受管请求头,不能把占位符作为请求密文;不得关闭证书校验。
curl --request GET "$ADMIN_ORIGIN/api/v1/admin/community/statistics" \
-H "Accept-Language: zh-CN" \
-H "X-Client-Type: admin" \
-H "X-Platform: web" \
-H "X-App-Version: 1.0.0" \
-H "X-App-Build: 1" \
-H "X-Channel: admin_web" \
-H "X-Device-Id: $INSTALLATION_UUID" \
-H "X-Request-Id: $REQUEST_UUID" \
-H "X-Request-Timestamp: $NOW_MILLIS" \
-H "Origin: $ADMIN_ORIGIN" \
-H "Cookie: __Secure-budyoo_admin=$ADMIN_COOKIE" \
-H "X-Budyoo-Encryption: jwe-v1" \
-H "Accept: application/jose" \
-H "X-Budyoo-JWE: $REQUEST_JWE"
成功响应¶
HTTP200,公共信封code=SUCCESS;message按中英日韩返回,未知或缺省语言回退英文。以下数量为合成示意。
{
"code": "SUCCESS",
"message": "操作成功",
"data": {
"posts": 2,
"comments": 3,
"postcardCards": 1,
"postcardReplies": 4,
"postcardReports": 2,
"reports": 5,
"postcards": 7,
"total": 17
},
"errors": []
}
所有data字段均为非空、非负整数,单位是待处理记录数。零表示查询确认无对应记录,失败不能当作零。全部字段来自同一只读数据库快照。
| 字段 | 统计范围/使用位置 |
|---|---|
| posts | 未删除且PENDING的动态;顶部“动态内容” |
| comments | 未删除且PENDING的评论及二级回复;顶部“评论与回复” |
| postcardCards | PENDING首信;明信片“首信”子入口 |
| postcardReplies | PENDING回信;明信片“回信”子入口 |
| postcardReports | RECEIVED或PROCESSING的明信片举报;明信片举报子入口 |
| reports | RECEIVED或PROCESSING的互动举报;顶部“举报处理” |
| postcards | postcardCards + postcardReplies + postcardReports;顶部“明信片审核” |
| total | posts + comments + postcards + reports;侧栏“动态审核” |
处理中举报仍属未结项,RESOLVED/DISMISSED不计入;已通过、驳回和下架内容不计入审核待处理数量,重新送审为PENDING后重新计入。话题配置保存即生效,无审核队列,不计入合计。
失败响应¶
| HTTP | code | 处理 |
|---|---|---|
| 400 | BAD_REQUEST / INVALID_CLIENT_HEADERS | 请求或公共头不合法 |
| 401 | UNAUTHORIZED | 管理员身份无效、过期或安装不匹配 |
| 403 | FORBIDDEN | 缺少后台读取权限或来源校验拒绝 |
| 426 | HTTPS_REQUIRED | 使用可信HTTPS入口 |
| 503 | SERVICE_UNAVAILABLE | 依赖不可用,保持未知并稍后重试 |
公共JWE错误和网关限流另见加密协议与入口限制。网关明文错误不能当作已认证JWE响应。
接入说明¶
气泡仅在数量大于0时显示;失败、退出或权限丢失时不显示伪造数字。顶部、明信片子分类与侧栏共用此汇总,不用当前列表页数、搜索结果或前端加减计算全局待办。明确审核或处理成功后重新读取;切回前台及可见期间按既有节奏核对,不对隐藏页面持续轮询。
2026-11-09服务器875项隔离回归通过,含3项新增统计集成测试;首次文档章节命名检查失败已修正并复验。验证覆盖各队列计数、已删除与终态排除、处理后更新、全局筛选隔离、OWNER/VIEWER权限、未登录及App身份拒绝、四语与英文回退。服务器网页类型检查和构建通过;48组四语桌面/手机隔离HTTPS/真实JWE布局验证入口数量、侧栏合计、零与失败隐藏、处理后刷新、旧响应取消及退出清理,合成业务写入1次,不操作真实审核数据。