Appearance
用户优惠券列表
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://gateway.nuoyunapi.com/Api/Coupon/getUserCouponList/2.0.0 - 频率限制:
10秒1000次
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| wechat_user_space_id | 是 | integer | 用户id |
| coupon_type | 是 | integer | 优惠券类型 1 商品券 2 奖品兑换券 |
| page | 是 | integer | 页码 |
| page_size | 是 | integer | 每页数量(最大50) |
请求示例
json
{
"wechat_user_space_id": 20401682,
"page": 1,
"page_size": 10,
"coupon_type": 2
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码:200-成功,400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | integer | 优惠券列表总数 |
| list | 是 | array | 优惠券列表 |
list 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| coupon_id | 是 | integer | 优惠券id |
| coupon_name | 是 | string | 优惠券名称 |
| coupon_type | 是 | integer | 优惠券类型(1-随机立减券,2-满减券,3-折扣券,4-奖品兑换券) |
| coupon_desc | 是 | string | 优惠信息描述 |
| card_no | 是 | string | 优惠券编码 |
| discount_money | 是 | integer | 优惠券金额 |
| gtime | 是 | integer | 领取时间 |
| status | 是 | integer | 优惠券状态 1:未使用;2:已占用;3:已使用;4已失效 |
| start_time | 是 | integer | 优惠券开始时间 |
| end_time | 是 | integer | 优惠券结束时间 |
| is_verify | 是 | integer | 优惠券使用时间 |
| verify_no | 是 | string | 优惠券核销码 |
响应示例
json
{
"code": 200,
"data": {
"total": 30,
"list": [
{
"coupon_id": 2843,
"coupon_name": "免费领取,线下核销免费领取,线下核销免费领取,线",
"coupon_type": 4,
"coupon_desc": "免费领取,线下核销免费领取,线下",
"card_no": "1520730507060",
"discount_money": "",
"gtime": 1755681079,
"status": 1,
"start_time": 1755681079,
"end_time": 2147483647,
"is_verify": 2,
"verify_no": "2419945807061"
}
]
},
"msg": "Success"
}