Appearance
获取优惠券详情2.0
| 拥有此API的权限集 |
|---|
| 营销码券管理-查询 |
请求方式及url
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://api.xiaoe-tech.com/xe.coupon.detail/2.0.0 - 频率限制:
10秒500次
接口调试
请求参数
响应结果
暂无响应数据
请求参数
| 参数名 | 必选 | 类型 | 说明 | 备注(示例) |
|---|---|---|---|---|
| access_token | 是 | string | 专属token | ... |
| coupon_id | 是 | string | 优惠券id | xx |
请求示例
{
"access_token": "xe_xxxxx",
"coupon_id": "xx"
}返回参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| code | 是 | int | 请求结果码 |
| msg | 是 | string | 描述信息 |
| data | 是 | object | 数据 |
数据列表data
| 参数名 | 必选 | 类型 | 说明 | 备注(示例) |
|---|---|---|---|---|
| id | 是 | string | 优惠券id | |
| app_id | 是 | string | 店铺id | |
| activity_id | 是 | string | 营销活动id | |
| title | 是 | string | 优惠券标题 | xxxxx |
| type | 是 | int | 优惠券类型 0-指定商品可用 1-全部商品可用 2-指定商品不可用 | |
| spread_type | 是 | int | 推广方式 0-用户领取 1-商家发放 2-兑换码兑换 3-不限方式 | |
| discount_way | 是 | int | 折扣方式,1-满减 2-折扣 | |
| discount_percent | 是 | int | 优惠券打几折,折扣力度百分比 【0-100】 | |
| discount_limit_price | 是 | int | 折扣上限, 最多优惠金额0-表示不限制 | |
| valid_after | 是 | int | 领取后多久后生效,单位: 天, 0-立即生效 ;-1-使用优惠券设置的有效期 | |
| valid_day | 是 | int | 优惠券有效期开始时间 | |
| can_use_with_activity | 是 | int | 允许与指定营销活动(秒杀、拼团、限时折扣等)叠加使用 1-允许 0-不允许 | |
| copy_from | 是 | string | 被复制的优惠券id | |
| is_show | 是 | int | 详情页是否显示 1-显示 0-不显示 | |
| valid_at | 是 | string | 开始有效期 | |
| invalid_at | 是 | string | 开始无效期 | |
| manual_stop_at | 是 | string | 手动结束领取时间 | |
| price | 是 | int | 满减券抵扣金额,单位:分 | 1000 |
| receive_rule | 是 | int | 每人限领 | |
| require_price | 是 | int | 最低消费金额 | |
| bind_res_count | 是 | int | 绑定资源数 | |
| count | 是 | int | 发行总量 | |
| has_received | 是 | int | 已领取总数 | |
| has_used | 是 | int | 已使用数量 | |
| can_share | 是 | int | 是否可以进行分享 1-可以 0-不可以 | |
| is_show_stock | 是 | int | 是否展示库存:0-不展示,1-展示 | |
| promote_goods_set | 是 | int | 推荐商品类型:1-最新商品, 2-指定商品 | |
| is_delete | 是 | int | 是否删除 0-不删除 1-已删除 | |
| is_hide | 是 | int | 是否在B端隐藏优惠券,0-不隐藏;1-隐藏 | |
| created_at | 是 | string | 创建时间 | |
| updated_at | 是 | string | 更新时间 | |
| coupon_type | 是 | int | 优惠券类型 1-通用优惠券,2-专属优惠券,3-员工优惠券 | |
| receive_limit_type | 是 | int | 限制身份领取类型 ,0-不限制,1-超级会员,2-用户人群,3-用户标签 | |
| receive_limit_ids | 是 | string | 领取限制关联ID,(json)id=关联id,title=冗余标题,is_free_vip=会员特殊逻辑,体验会员 | |
| instructions | 是 | string | 优惠券使用说明 | |
| plans | 是 | array | 定向计划 | |
| resource | 是 | array | 只有type=0时才会返回,优惠券所包含的资源信息 | |
| bind_resources | 是 | array | 只有type=1和type=2时才会返回,当type=2时返回,表示里面的商品不可用,当type=1时,bing_resources为空 | |
| unsupport_resource | 是 | array | 指定商品不可用 当type=2时才会返回 | [] |
优惠券所包含的资源信息resource&指定商品不可用unsupport_resource
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | id |
| spu_id | string | spu id |
| goods_id | string | 商品id |
| resource_id | string | 资源id |
| sku_id | string | sku id |
| title | string | 标题 |
| summary | string | 简介 |
| org_content | string | 原始HTML内容 |
| descrb | string | 专栏描述(Json格式, type:0-文字 1-图片) |
| img_url | string | 封面图片url |
| img_url_compressed | string | 封面压缩图片url |
| count | string | 数量 |
| price | int | 价格 |
| stock | int | 库存 |
| high_price | int | 最高价 |
| low_price | int | 最低价 |
| line_price | int | 划线价 |
| is_package | int | true表示实物带货商品 |
| created_at | string | 创建时间 |
| enough_price | int | 是否足够金额消费 1-满足 0-不满足 |
| resource_type | int | 资源类型 |
| sku | array | 规格相关信息 |
| sku[].sku_id | string | 规格id |
| sku[].sku_price | int | 规格价格,单位:分 |
绑定的资源bind_resources
| 参数名 | 类型 | 说明 |
|---|---|---|
| resource_id | string | 资源ID |
| resource_type | int | 资源类型 |
| cou_id | int | 优惠券ID |
返回示例
{
"code": 0,
"msg": "获取优惠券详情成功",
"data": {
"id": "cou_xxxx",
"app_id": "appxxx",
"activity_id": "ma_cu_xxxx",
"title": "20210809专属优惠卷",
"type": 0,
"spread_type": 3,
"discount_way": 1,
"discount_percent": 0,
"discount_limit_price": 0,
"valid_after": 0,
"valid_day": 20
"can_use_with_activity": 1,
"copy_from": "",
"is_show": 0,
"valid_at": null,
"invalid_at": null,
"manual_stop_at": null,
"price": 11200,
"receive_rule": 0,
"require_price": 0,
"bind_res_count": 1,
"count": 200,
"has_received": 0,
"has_used": 0,
"can_share": 1,
"is_show_stock": 0,
"promote_goods_set": 0,
"is_delete": 0,
"is_hide": 0,
"created_at": "2021-08-12 18:15:19",
"updated_at": "2021-08-12 18:15:19",
"coupon_type": 1,
"receive_limit_type": 0,
"receive_limit_ids": "",
"instructions": "",
"bind_resources": [],
"unsupport_resource": [],
"resource": [
{
"id": "SPU_xxxx",
"spu_id": "SPU_xxxx",
"goods_id": "SPU_xxxx",
"resource_id": "g_xxx",
"sku_id": "SKU_xxxx",
"title": "寄到海外",
"summary": "",
"org_content": "",
"descrb": "",
"img_url": "http://xxxx.gif",
"img_url_compressed": "http://xxx.gif",
"count": "",
"price": 11100,
"stock": 1231,
"high_price": 11100,
"low_price": 11100,
"line_price": 0,
"is_package": 0,
"created_at": "2021-08-12 16:53:21",
"enough_price": 1,
"resource_type": 21,
"sku": [
{
"sku_id": "SKU_ENT_6290959917748LkTBQ58",
"sku_price": 1100
}
],
}
],
"plans": []
}
}