DELETE/api/v1/admin/posts/{id}
管理员Cookie,ADMIN_POSTS_WRITE,HTTPS;Origin与CSRFJSON 响应接入指南 ↗

删除已通过动态

请求参数

路径 id 为必填动态UUID,无业务查询参数。解密后的JSON正文只允许下列字段:

字段 类型 规则
expectedVersion 必填JSON整数 当前动态审核version,范围0至9223372036854775807;不接受null、字符串、浮点、布尔或负数

版本取列表或详情的 post.version/列表项version,不是作者资料版本。未知字段一律400,包括作者、管理员、正文、状态、原因和删除时间;不能指定强制删除策略。只有未删除、审核状态为APPROVED且版本匹配的目标可以删除;待审、已驳回、已下架、已删除和旧版本均409,不存在404。

独立管理员认证,仅ADMIN_POSTS_WRITE(当前OWNER),VIEWER只读。Cookie与安装绑定,Origin必须为当前后台源,写请求必带X-Admin-CSRF;App Bearer不能代替管理员身份。公共请求头和四语Accept-Language沿用原契约。JSON使用AES/JWE,DELETE的密文放正文,始终HTTPS,不适用App开发HTTP例外。

请求示例

下列均为合成示例,先按真实路径、方法、当前公共头及请求体生成JWE,不直接发送占位密文。

{
  "expectedVersion": 3
}
curl --request DELETE "$ADMIN_ORIGIN/api/v1/admin/posts/11111111-1111-4111-8111-111111111111" \
  -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: $ADMIN_CSRF" \
  -H "X-Budyoo-Encryption: jwe-v1" \
  -H "Accept: application/jose" \
  -H "Content-Type: application/jose" \
  --data-raw "$REQUEST_JWE"

成功响应

HTTP200,真实外层响应为JWE;解密后的公共信封中data固定null。

{
  "code": "SUCCESS",
  "message": "操作成功",
  "data": null,
  "errors": []
}

删除与审核/作者删除共用动态行锁。正文、当前及历史审核原因、点赞、图片/音视频与话题引用按原删除事务清理,审核版本递增并写deletedAt墓碑;图片和音视频的物理字节由既有持久队列后续回收,外部文件失败不恢复公开。保留原幂等UUID,不能通过重复发帖或重审恢复内容。管理员审计同事务,仅记POST_DELETE、真实操作者及APPROVED:旧版本→DELETED:新版本,不复制正文、图片、原因或会话凭据。审计失败回滚删除及回收任务。

失败响应

HTTP code 处理
400 BAD_REQUEST / INVALID_CLIENT_HEADERS 必填版本、类型、范围、未知字段或公共头不合法
401 UNAUTHORIZED Cookie无效/过期或安装不符
403 FORBIDDEN 非OWNER、权限不足、Origin或CSRF不符;App身份不能访问
404 NOT_FOUND 动态不存在
409 POST_REVIEW_CONFLICT 已非APPROVED、版本变化或已经删除,先读取最新状态
426 HTTPS_REQUIRED 按管理员HTTPS/JWE契约访问
503 SERVICE_UNAVAILABLE 必要依赖或审计失败,不伪装删除成功

其他JWE、正文大小及网关限流见加密协议和入口限制。HTTP状态与固定code共同判断,message使用当前语言,未知语言回退英文。

接入说明

已通过且未删除行对有写权限的管理员显示“删除”;先二次确认,取消不发请求。删除不要求图片可读或视频可播放,仍必须匹配当前版本。提交中禁重复、切换与离开;成功重读当前筛选和状态统计,页末最后一行删除后回到上一页。网络失败/超时、503、404或409后锁定该行,先显式刷新核对,不自动重发。重复DELETE并非“已删除也报成功”,仍409;未知结果通过详情的deletedAt或重新查询列表确认。

APPROVED与ALL列表不再返回墓碑,既有state=DELETED可查询无正文、无媒体的记录;后台详情仍可读取墓碑与无内容轨迹。App本人、他人、动态媒体、评论与翻译按父动态删除规则不可读,已有私有举报及评论的留存沿原领域规则,不宣称清除所有历史或备份副本。下架仍是独立HIDE动作,保留原说明及媒体语义。

2026-11-11服务器隔离PostgreSQL/Redis完整clean verify通过1091项,0失败/错误/跳过;新增21项删除回归(17项业务、3项安全、1项V41→V42升级)覆盖四种内容、正文/原因/点赞/媒体/话题清理、幂等墓碑、父动态公开权限、旧版本及非已通过状态、重复/并发删除、审计故障完整回滚、损坏媒体不阻塞、四语与回退、Cookie/App隔离、VIEWER、Origin/CSRF/安装/公共头及严格输入。正向删除经真实HTTP控制器和JWE只使用隔离合成内容。后台浏览器隔离夹具及真实受信HTTPS候选页面各通过四语×桌面/手机8组。夹具覆盖确认/取消、版本载荷、成功刷新、409/503锁定、在途防重、媒体失败仍可删除、VIEWER及四语审计;真实页面只核对按钮和确认/取消,不发送删除。开发版本20261111-approved-post-delete-140905已部署,Flyway为V42;迁移只更新删除边界COMMENT,不删除运行内容。独立备份恢复、发布前新备份摘要、源码/镜像/运行JAR及后台产物核对通过。发布后真实受信HTTPS四语×桌面/手机8组核对删除按钮、确认文案和取消后保留原列表通过,非认证业务写入均拦截,真实删除/审核写入0,验收会话已退出。运行动态7条、用户28个、举报及POST_DELETE审计均0,发布前后动态摘要保持;正向删除只在隔离环境执行。