# 获取用户优惠券列表
# 接口调用说明
http请求方式：POST
https://api.weixin.qq.com/shop/coupon/get_usercoupon_list?access_token=xxxxxxxxx
# 请求参数示例
{
"page_size": 2,
"offset": 1,
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io"
}
# 回包示例
{
"errcode": 0,
"total_num": 3,
"result_list": [{
"out_user_coupon_id": "out_user_coupon_id_1",
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io",
"out_coupon_id": "coupon_id_1",
"status": 100,
"create_time": 1625474308,
"update_time": 1625474308,
"end_time": 1625464250,
"ext_info": {},
"start_time": 1625451250
}, {
"out_user_coupon_id": "out_user_coupon_id_2",
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io",
"out_coupon_id": "out_coupon_id_3",
"status": 102,
"create_time": 1625237877,
"update_time": 1625237997,
"end_time": 0,
"ext_info": {
"use_time": 1625237997
},
"start_time": 0
}]
}
# 请求参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| page_size | number | 是 | 页大小,最大为200 |
| offset | number | 否 | 偏移量,从0开始 |
# 回包参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| total_num | number | 总量 |
| result_list.out_user_coupon_id | string | 商家侧用户优惠券ID |
| result_list.openid | string | openid |
| result_list.out_coupon_id | string | 商家侧优惠券ID |
| result_list.status | number | 用户优惠券状态 |
| result_list.create_time | number | 用户优惠券创建时间（秒级时间戳） |
| result_list.update_time | number | 用户优惠券更新时间（秒级时间戳） |
| result_list.start_time | number | 用户优惠券有效开始时间（秒级时间戳） |
| result_list.end_time | number | 用户优惠券有效结束时间（秒级时间戳） |
| result_list.ext_info.use_time | number | 核销时间（秒级时间戳） |