模块说明
coupon 提供优惠券能力：领券（幂等，重复领取不重复发放）与我的优惠券列表；结算环节的使用入口在订单模块（order/checkout/use_coupon）。
鉴权级别：领券与我的优惠券均必须登录。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/coupon |
公开 |
模块入口（占位，返回空数据） |
| POST |
/api/coupon/claim |
必须 |
领取优惠券 |
| GET |
/api/user/coupon |
必须 |
我的优惠券列表 |
领取优惠券 POST /api/coupon/claim
| 参数 |
必填 |
说明 |
id |
是 |
优惠券 ID（0 时仅占位返回，不发放） |
{
"code": "OK",
"message": "领取成功",
"data": {
"coupon_list": [ { "id": 1, "name": "...", "money": "...", "...": "" } ]
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
- 幂等：已领取过同一券时再次调用不会重复发放，仍返回
200；
id > 0 时返回领取后的全量优惠券列表（coupon_list），便于客户端直接刷新。
我的优惠券 GET /api/user/coupon
{
"code": "OK",
"message": "",
"data": {
"title": "我的优惠券",
"coupon_list": [ { "id": 1, "name": "...", "status": "...", "...": "" } ],
"pager": { "...": "分页信息" },
"total": 3
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 结算抵扣在订单模块：
POST /api/order/checkout 返回可用券，POST /api/order/checkout/use_coupon 应用券并重算金额；
- 领券为登录接口，未登录由鉴权层返回
401 UNAUTHORIZED。