guke
b23335d5fb
docs: reorganize api docs into categorized subdirectories and fill missing docs - Categorize 77 existing api docs into 16 business-domain subdirectories (auth/ad/wallet/coupon/compare/savings/signin/tasks/invite/user/ device/platform/intent/meituan/other) plus admin/ and internal/ - Split admin/ into 7 sub-resource subdirectories (auth/users/wallet/ withdraws/feedbacks/admins/ad) with 4 single-file docs at root - Create 21 new docs covering 28 previously undocumented endpoints: ad/watch-report, wallet/transfer-auth (3 endpoints), coupon/session+ stats+completed-today+prompt (7), invite/me+invitees+bind+landing-track, user/onboarding (2), platform/flags+ad-config+app-version, intent/step+precoupon/step, analytics/events, order/report, report/submit+records, feedback/config+records, trace/finalize - Add mock request/response JSON examples to all new docs - Create docs/README.md with full category index for LLM navigation - Update docs/api/README.md: fix all links, add new endpoint rows, replace "no doc" markers with actual links - Fix back-navigation links (./README.md -> ../README.md or ../../README.md) in all moved files @
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 比价场景反馈）