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

GET /admin/api/feedbacks — 反馈工单列表(offset 分页 + 筛选/排序)

所属:Admin·反馈组（前缀 /admin/api/feedbacks） | 鉴权:Bearer admin_token（角色:任意已登录管理员,无 require_role,仅 get_current_admin） | ← 返回 API 索引

入参（query）

字段	类型	必填	默认	说明
`status`	string	❌	null	反馈状态,精确匹配:`new`(待处理) / `handled`(已处理);传空/不传则不筛
`user_id`	int	❌	null	按提交用户 id 精确筛
`content`	string	❌	null	反馈内容模糊匹配(ilike,≤100 字)
`created_from`	datetime	❌	null	提交时间 ≥(ISO,统一按 UTC 比较)
`created_to`	datetime	❌	null	提交时间 ≤(ISO,统一按 UTC 比较)
`sort_by`	string	❌	`id`	排序列:`id` / `created_at`
`sort_order`	string	❌	`desc`	`asc` / `desc`
`limit`	int	❌	20	1–100
`cursor`	int	❌	null	上一页 next_cursor(offset 分页,cursor=offset)

响应 200:{ items: FeedbackOut[], next_cursor: int|null }(next_cursor=null 表示末页)

FeedbackOut

字段	类型	说明
`id`	int	反馈 id
`user_id`	int	提交用户 id
`content`	string	反馈内容
`contact`	string	联系方式(微信/QQ/手机,便于回访)
`images`	string[] \| null	截图相对路径列表(如 `["/media/feedback/u1_ab12.jpg"]`),无图为 null
`status`	string	反馈状态:`new`(待处理) / `handled`(已处理)
`created_at`	datetime	提交时间(UTC)

offset 分页(同 admin-users-list):cursor 即 offset,传上一页返回的 next_cursor;next_cursor=null 即末页。改用 offset 是为了在任意列排序下游标语义统一,代价是翻页期间数据变动可能错位一条(admin 低频可接受)。
排序:sort_by(id/created_at)× sort_order(asc/desc),恒以 id 同向兜底次序。
status / user_id 精确匹配、content 模糊、created_from/created_to 时间范围,均可叠加。
关联表 feedback;截图为相对路径,经 GET /media/feedback/<file> 静态读。