a563c1ca4b
docs/api目录文档分类和补全 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #111
2.2 KiB
2.2 KiB
GET /api/v1/feedback/records — 我的反馈历史
所属:Feedback 组(前缀
/api/v1/feedback) | 鉴权:Bearer | ← 返回 API 索引
查询当前用户提交的反馈历史,支持按状态筛选。
入参(query)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status |
string | null | ❌ | 筛选状态:pending / adopted / rejected;不传 = 全部 |
Mock 请求:
GET /api/v1/feedback/records?status=adopted
出参
响应 200:FeedbackRecordsOut
| 字段 | 类型 | 说明 |
|---|---|---|
records |
list[FeedbackRecordOut] | 反馈记录列表 |
records[].id |
int | 反馈 ID |
records[].content |
string | 反馈正文 |
records[].scene |
string | null | 问题场景(比价结果页反馈时带,如 找错商品) |
records[].images |
list[string] | 截图 URL 列表 |
records[].status |
string | pending / adopted / rejected |
records[].reject_reason |
string | null | 驳回原因 |
records[].reward_coins |
int | null | 采纳后发的金币数 |
records[].admin_reply |
string | null | 管理员回复 |
records[].created_at |
datetime | 提交时间 |
counts |
object | 三态计数(不受 status 筛选影响) |
counts.all |
int | 总数 |
counts.pending |
int | 待处理 |
counts.adopted |
int | 已采纳 |
counts.rejected |
int | 已驳回 |
Mock 出参:
{
"records": [
{
"id": 56,
"content": "比价结果显示美团 28.5 元,但实际下单时涨到了 32 元",
"scene": "价格不一致",
"images": ["/media/feedback/u42_f1e2d3c4b5a60708.jpg"],
"status": "adopted",
"reject_reason": null,
"reward_coins": 500,
"admin_reply": "感谢反馈,已核实并修复",
"created_at": "2026-07-02T15:20:00Z"
}
],
"counts": {
"all": 3,
"pending": 1,
"adopted": 2,
"rejected": 0
}
}
错误码
400无效的status值(仅pending/adopted/rejected合法)401未鉴权
说明
counts始终基于全量(不受status筛选影响),供前端筛选 chipscene仅比价结果页反馈时带(区分普通反馈 vs 比价场景反馈)