GET/api/v1/admin/community/statistics
管理员Cookie,ADMIN_POSTS_READ,HTTPS与完整后台公共头JSON 响应接入指南 ↗

读取审核工作区待处理数量

请求参数与权限

无业务正文或必填查询参数。统计是全局待处理队列,列表的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次,不操作真实审核数据。