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 @
1.7 KiB
1.7 KiB
POST /api/v1/feedback — 提交反馈
所属:Feedback 组（前缀
/api/v1/feedback） | 鉴权:Bearer access_token | ← 返回 API 索引
入参
multipart/form-data:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
content |
string | ✓ | 反馈正文,1-200 字(strip 后) |
contact |
string | ✗ | 联系方式(微信/QQ/手机号),≤128 字。原型改版后客户端已不再采集、不传该字段(后端默认空串);保留字段兼容旧端 |
images |
file[] | ✗ | 截图,最多 6 张,每张走头像同款校验(JPEG/PNG/WebP,≤ 5 MB,魔数嗅探) |
出参
响应 200:
{
"id": 123,
"status": "new",
"created_at": "2026-05-29T12:34:56Z"
}
| 字段 | 类型 | 说明 |
|---|---|---|
id |
int | 反馈单 ID |
status |
string | new(待处理)/ handled(已处理) |
created_at |
datetime | 提交时间(UTC) |
不返回上传的 image URL——这是给运营后台看的,客户端通常不需要。
错误码
400内容为空 / 内容超 200 字 / 联系方式超 128 字 / 图片超 6 张 / 单图非法(空/过大/格式不对)401未带 token / token 无效或过期 / 用户被禁用422缺content字段
说明
- 反馈绑用户:
feedback.user_id = current_user.id,便于回访 - 截图落盘:存到
settings.MEDIA_ROOT/feedback/,URL 写进feedback.images(JSON 列,SQLite 是 TEXT、PG 是 JSON/JSONB——为不影响现有迁移用 JSON 而非 JSONB) - 截图可读:
GET /media/feedback/<file>静态服务暴露,详见 API 索引 — /media 静态服务 - 文件名随机
u<user_id>_<rand>.<ext>,杜绝路径穿越