POST/api/v1/admin/topics/{id}/review
管理员Cookie,ADMIN_POSTS_WRITE,HTTPS;写请求CSRFJSON 响应接入指南 ↗

已停用的话题审核入口

话题不需要审核。使用创建话题或保存话题,保存成功后立即展示。此旧地址仅保留明确的停用响应,不支持通过、驳回、下架或重新送审。

请求参数与鉴权

路径id为话题稳定代码。旧正文中的expectedVersion、action和reason不再参与业务处理;不会根据动作或版本写入任何数据。请求仍必须经过管理员Cookie、ADMIN_POSTS_WRITE、HTTPS、Origin、CSRF、公共请求头和AES/JWE检查。OWNER可到达停用响应,VIEWER写请求返回403,未登录返回401;未知语言回退英文。

请求示例

以下展示旧客户端的迁移边界,不应继续调用。业务JSON例如{"expectedVersion":0,"action":"HIDE","reason":"旧页面请求"};请求按真实路径和公共头生成JWE,不关闭TLS校验。

curl --request POST "$ADMIN_ORIGIN/api/v1/admin/topics/window/review" \
  -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: 33333333-3333-4333-8333-333333333333" \
  -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-Admin-CSRF: $CSRF_TOKEN" \
  -H "X-Budyoo-Encryption: jwe-v1" \
  -H "Accept: application/jose" \
  -H "Content-Type: application/jose" \
  --data-raw "$REQUEST_JWE"

成功响应

本端点已停用,不再返回业务成功响应。

失败响应

通过公共协议及权限检查后固定返回HTTP405,不读取话题是否存在,不修改状态、版本、正文或管理员审计。

{"code":"METHOD_NOT_ALLOWED","message":"不支持此 HTTP 请求方法。","data":null,"errors":[]}

message为本次请求语言,以上为合成示意。

HTTP code 原因
405 METHOD_NOT_ALLOWED 话题审核已停用,改用配置保存接口
401 UNAUTHORIZED 管理员身份无效
403 FORBIDDEN / ADMIN_CSRF_INVALID 权限、来源或CSRF校验失败
400 INVALID_CLIENT_HEADERS 必填公共头不合法
426 HTTPS_REQUIRED 必须使用受信HTTPS

公共JWE错误与入口限制仍按加密协议和入口限制处理。

接入说明

2026-11-09已部署,隔离回归验证四种旧动作均返回405且配置与审计不变。保存与迁移等话题相关13项测试通过,整个服务器测试报告累计828项通过。