# 获取券ID对应的详情内容
# 接口说明
可通过该接口,可获取券ID对应的详情内容
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/promoter/get_coupon_detail?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
coupon_id | string | 是 | 券id |
# 请求参数示例
{
"coupon_id": "COUPON_ID"
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
next_key | string | 分页参数,第一页为空,后面请求返回上一次请求返回的 next_key |
has_more | bool | 是否还有更多,如果返回为true,表示 |
coupon | array object coupon | 推客的绑定参数列表 |
# 结构体
# coupon
券信息
参数 | 类型 | 描述 |
---|---|---|
coupon_id | string | 券的 id |
coupon_id | string | 优惠券ID |
shop_appid | string | 优惠券所属店铺id |
type | number | 优惠券类型,枚举值详情请参考type |
status | number | 优惠券状态 |
create_time | number | 优惠券创建时间 |
update_time | number | 优惠券更新时间 |
coupon_info.name | string | 优惠券名称 |
coupon_info.valid_info.valid_type | number | 优惠券有效期类型,枚举值详情请参考valid_type |
coupon_info.valid_info.valid_day_num | number | 优惠券有效天数,valid_type=2时才有意义 |
coupon_info.valid_info.start_time | number | 优惠券有效期开始时间,valid_type=1时才有意义 |
coupon_info.valid_info.end_time | number | 优惠券有效期结束时间,valid_type=1时才有意义 |
stock_info.issued_num | number | 优惠券剩余量 |
stock_info.receive_num | number | 优惠券领用但未使用量 |
stock_info.used_num | number | 优惠券已用量 |
coupon_info.discount_info.discount_num | number | 优惠券折扣数 * 1000, 例如 5.1折-> 5100 |
coupon_info.discount_info.discount_fee | number | 优惠券减少金额, 单位分, 例如0.5元-> 50 |
coupon_info.discount_info.discount_condition.product_cnt | number | 优惠券使用条件, 满 x 件商品可用 |
coupon_info.discount_info.discount_condition.product_price | number | 优惠券使用条件, 价格满 x 可用,单位分 |
coupon_info.discount_info.discount_condition.product_ids[] | string array | 优惠券使用条件, 指定商品 id 可用 |
coupon_info.ext_info.invalid_time | number | 优惠券失效时间 |
coupon_info.ext_info.valid_time | number | 优惠券有效时间 |
coupon_info.receive_info.end_time | number | 优惠券领用结束时间 |
coupon_info.receive_info.limit_num_one_person | number | 单人限领张数 |
coupon_info.receive_info.start_time | number | 优惠券领用开始时间 |
coupon_info.receive_info.total_num | number | 优惠券领用总数 |
# 返回参数示例
{
"errcode": "0",
"errmsg": "ok",
"coupon": {
"coupon_id": "111111111",
"type": 103,
"status": 5,
"create_time": 1594885385,
"update_time": 1594886327,
"coupon_info": {
"name": "scs",
"discount_info": {
"discount_num": 9900
},
"receive_info": {
"end_time": 1673110742,
"limit_num_one_person": 1,
"start_time": 1673110742,
"total_num": 100
},
"valid_info": {
"valid_type": 1,
"valid_day_num": 0,
"start_time": 1594828800,
"end_time": 1595433600
}
},
"stock_info": {
"issued_num": 95,
"receive_num": 3,
"used_num": 2
}
}
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10024000 | 参数错误 |