WonderableAI/shaguabijia-app-server

Files

T

guke a563c1ca4b @ (#111 )

docs/api目录文档分类和补全

---------

Co-authored-by: guke <guke@autohome.com.cn>
Reviewed-on: #111

2026-07-03 15:00:37 +08:00

1.1 KiB

Raw Blame History

POST /admin/api/feedbacks/{feedback_id}/handle — 标记反馈已处理

所属:Admin·反馈组（前缀 /admin/api/feedbacks） | 鉴权:Bearer admin_token（角色:operator,super_admin 恒通过,require_role("operator")） | ← 返回 API 索引

入参

路径:feedback_id(int)
body:无

出参

响应 200:OkResponse = { "ok": true }

幂等说明:将该反馈 status 置为 handled(不校验原状态,重复调用结果一致)。

错误码

401 未带/无效/过期 admin token、管理员被禁用(头带 WWW-Authenticate: Bearer)
403 角色不足(需 operator 或 super_admin)
404 反馈不存在(detail: "反馈不存在")
422 feedback_id 非合法 int

说明

写操作记审计 admin_audit_log:action="feedback.handle"、target_type="feedback"、target_id=<feedback_id>、detail={"before": <原 status>, "after": "handled"}、ip=<客户端 IP>。
状态变更与审计写入在同一事务(commit=False 后统一 db.commit())。
关联表 feedback。