模块说明
share 提供分享奖励能力：会员提交分享/晒单内容（图片先行上传），后台审核后发放奖励。上传采用草稿令牌（draft_token）机制：申请表单阶段获取令牌，图片以令牌归属临时存储，提交申请时凭令牌认领。
鉴权级别：全部必须登录。同一会员同时只允许存在一条待处理申请。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/share |
公开 |
模块入口（占位，返回空数据） |
| GET |
/api/user/share |
必须 |
我的分享记录 |
| GET |
/api/user/share/apply |
必须 |
申请表单数据（含 draft_token） |
| POST |
/api/user/share/apply_post |
必须 |
提交分享申请 |
我的分享记录 GET /api/user/share
{
"code": "OK",
"message": "",
"data": {
"title": "分享记录",
"share_list": [ { "id": 1, "status": "...", "add_time": "...", "...": "" } ],
"pager": { "...": "分页信息" },
"total": 2
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
申请表单 GET /api/user/share/apply
获取申请表单时服务端会：清理该会员的旧草稿图片 → 生成新的 draft_token → 返回当前草稿图集。
{
"code": "OK",
"message": "",
"data": {
"title": "申请分享",
"draft_token": "d1f2e3...",
"img_list_html": [ "...草稿图集 HTML 片段..." ]
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 场景 |
响应 |
| 已有待处理申请 |
422 BUSINESS_RULE_VIOLATION（share_apply_exist） |
图片上传使用通用会员上传接口（POST /api/user/filebox，user 草稿模式），上传时携带 draft_token 归属草稿。
提交分享申请 POST /api/user/share/apply_post
| 参数 |
必填 |
说明 |
draft_token |
是 |
申请表单阶段下发的草稿令牌（提交时认领该令牌下的图片） |
| 分享内容字段 |
是 |
由分享服务校验（如内容文案等，以实际表单为准） |
{
"code": "OK",
"message": "申请已提交",
"data": {},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 场景 |
响应 |
| 已有待处理申请 |
422 BUSINESS_RULE_VIOLATION（share_apply_exist） |
| 提交失败（令牌失效/内容不符） |
422 BUSINESS_RULE_VIOLATION（share_apply_wrong） |
注意事项
- 草稿令牌时序：必须"先调
apply 拿 draft_token → 再用该令牌上传图片 → 最后 apply_post 提交"，令牌缺失或过期会导致提交失败；
- 重复进入申请表单会清理旧草稿，客户端不应缓存历史
draft_token；
- 申请审核状态体现在我的分享记录列表。