# 获取优惠券列表
# 接口调用说明
http请求方式：POST
https://api.weixin.qq.com/shop/coupon/get_list?access_token=xxxxxxxxx
# 请求参数示例
{
"page_size": 3,
"offset": 2
}
# 回包示例
{
"errcode": 0,
"total_num": 10,
"result_list": [
{
"coupon": {
"out_coupon_id": "out_coupon_id_3",
"type": 101,
"promote_type": 4,
"coupon_info": {
"name": "测试3",
"promote_info": {
"promote_type": 4,
"finder": {}
},
"receive_info": {
"total_num": 100
},
"ext_info": {
"valid_time": 1625226181
}
},
"status": 0,
"create_time": 1625218450,
"update_time": 1625238573,
"appid": "wx9e20708660a0991b"
},
"coupon_stock": {
"out_coupon_id": "out_coupon_id_3",
"stock_info": {
"issued_num": 99,
"receive_num": 1
},
"create_time": 1625226181,
"update_time": 1625237877,
"appid": "wx9e20708660a0991b"
}
},
{
"coupon": {
"out_coupon_id": "out_coupon_id_4",
"type": 101,
"promote_type": 4,
"coupon_info": {
"name": "测试4",
"promote_info": {
"promote_type": 4,
"finder": {}
},
"receive_info": {
"total_num": 1000
}
},
"status": 1,
"create_time": 1625239595,
"update_time": 1625239595,
"appid": "wx9e20708660a0991b"
}
},
{
"coupon": {
"out_coupon_id": "coupon_id_1",
"type": 101,
"promote_type": 4,
"coupon_info": {
"name": "示例优惠券",
"promote_info": {
"promote_type": 4,
"finder": {
"nickname": "视频号昵称"
}
},
"discount_info": {
"discount_condition": {
"product_cnt": 2,
"product_price": 5000,
"out_product_ids": ["product_id_3", "product_id_4"],
"tradein_info": {
"out_product_id": "product_id_5",
"price": 10000
},
"buyget_info": {
"buy_out_product_id": "product_id_1",
"buy_product_cnt": 3,
"get_out_product_id": "product_id_2",
"get_product_cnt": 2131241242
}
},
"discount_num": 9800,
"discount_fee": 6400
},
"receive_info": {
"start_time": 1625451250,
"end_time": 1625454250,
"limit_num_one_person": 10,
"total_num": 100
},
"valid_info": {
"valid_type": 1,
"valid_day_num": 10,
"valid_second": 3600,
"start_time": 1625451250,
"end_time": 1625464250
},
"ext_info": {
"valid_time": 1625473652
}
},
"status": 2,
"create_time": 1625454641,
"update_time": 1625473652,
"appid": "wx9e20708660a0991b"
},
"coupon_stock": {
"out_coupon_id": "coupon_id_1",
"stock_info": {
"issued_num": 99,
"receive_num": 1
},
"create_time": 1625473652,
"update_time": 1625474308,
"appid": "wx9e20708660a0991b"
}
}]
}
# 请求参数说明
参数 | 类型 | 是否必填 | 说明 --- | --- | --- page_size | number | 是 | 页大小,最大为200 offset | number | 否 | 偏移量,从0开始
# 回包参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| total_num | number | 总量 |
| coupon.out_coupon_id | string | 商家侧优惠券ID |
| coupon.type | number | 优惠券类型 |
| coupon.promote_type | number | 优惠券推广类型 |
| coupon.coupon_info.name | string | 优惠券名 |
| coupon.coupon_info.promote_info.promote_type | number | 优惠券推广类型 |
| coupon.coupon_info.promote_info.finder.nickname | string | 推广视频号昵称 |
| coupon.coupon_info.discount_info.discount_condition.product_cnt | number | 商品数 |
| coupon.coupon_info.discount_info.discount_condition.product_price | number | 商品金额 |
| coupon.coupon_info.discount_info.discount_condition.out_product_ids | string array | 指定商品商家侧ID |
| coupon.coupon_info.discount_info.discount_condition.tradein_info.out_product_id | string | 换购商品商家侧ID |
| coupon.coupon_info.discount_info.discount_condition.tradein_info.price | number | 需要支付的金额，单位分 |
| coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_out_product_id | string | 购买商品商家侧ID |
| coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_product_cnt | number | 购买商品数 |
| coupon.coupon_info.discount_info.discount_condition.buyget_info.get_out_product_id | string | 赠送商品商家侧ID |
| coupon.coupon_info.discount_info.discount_condition.buyget_info.get_product_cnt | number | 赠送商品数 |
| coupon.coupon_info.discount_info.discount_num | number | 折扣数,比如5.1折,则为5100 |
| coupon.coupon_info.discount_info.discount_fee | number | 减金额,单位为分 |
| coupon.coupon_info.receive_info.start_time | number | 领取开始时间（秒级时间戳） |
| coupon.coupon_info.receive_info.end_time | number | 领取结束时间（秒级时间戳） |
| coupon.coupon_info.receive_info.limit_num_one_person | number | 领张数 |
| coupon.coupon_info.receive_info.total_num | number | 总发放量 |
| coupon.coupon_info.valid_info.valid_type | number | 有效期类型,1:商品指定时间区间,2:生效天数,3:生效秒数 |
| coupon.coupon_info.valid_info.valid_day_num | number | 生效天数 |
| coupon.coupon_info.valid_info.valid_second | number | 生效秒数 |
| coupon.coupon_info.valid_info.start_time | number | 生效开始时间 |
| coupon.coupon_info.valid_info.end_time | number | 生效结束时间（秒级时间戳） |
| coupon.status | number | 优惠券状态（秒级时间戳） |
| coupon.create_time | number | 创建时间（秒级时间戳） |
| coupon.update_time | number | 更新时间（秒级时间戳） |
| coupon.coupon_stock.out_coupon_id | string | 商家侧优惠券ID |
| coupon.coupon_stock.stock_info.issued_num | number | 优惠券库存剩余量 |
| coupon.coupon_stock.stock_info.receive_num | number | 优惠卷发放量 |
| coupon.coupon_stock.create_time | number | 创建时间（秒级时间戳） |
| coupon.coupon_stock.update_time | number | 更新时间（秒级时间戳） |