创建优惠码
| 拥有此API的权限集 |
|---|
| 营销码券管理-增删改 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.promo_code.create_code/1.0.0 - 频率限制:
10秒500次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| name | 是 | string | 优惠码名称 |
| note | 否 | string | 内部备注 |
| ptype | 是 | string | 优惠码类型:0通用码,1专属码 |
| start_at | 是 | string | 开始时间 |
| end_at | 是 | string | 结束时间 |
| total_num | 是 | string | 发放总量 |
| style | 是 | string | 优惠类型:0全额抵扣,1满减,2折扣 |
| min_charge | 是 | string | 使用门槛:0表示无门槛 |
| discount | 是 | string | 优惠额,若是折扣类表示百分比0-100 |
| discount_limit | 否 | string | 折扣上限, 最多优惠金额【0表示不限制】 |
| bind_res_type | 是 | string | 绑定资源类型:0全部1指定商品 |
| user_limit | 是 | string | 限领/限用条件:默认每人1张,0表示不限 |
| can_share | 是 | string | 是否可以分享:0否1是 |
| use_in_acts | 是 | string | 是否允许与指定营销活动（秒杀、拼团、限时折扣等）叠加使用,默认0可以叠加，1不能叠加 |
| remark | 否 | string | 使用说明 |
| code | 否 | string | 通用码号:专属码会预生成码库 |
| resource | 否 | array | 指定商品可用的商品信息 |
| information_data | 否 | array | 信息采集，不需要信息采集两个字段传空字符串 |
resource指定商品可用的商品信息
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| resource_id | 是 | string | 资源id，指定商品时必填 |
| resource_type | 是 | string | 资源类型，指定商品时必填 |
information_data信息采集
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| form_name | 是 | string | 信息采集id |
| in_id | 是 | string | 信息采集名称 |
请求示例
{
"app_id": "dss",
"name": "dss",
"note": "22",
"ptype": "1",
"start_at": "2021-12-01 14: 59: 19",
"end_at": "2021-12-18 00: 00: 00",
"total_num": "22",
"style": "1",
"min_charge": "0",
"discount": "22",
"discount_limit": "0",
"bind_res_type": "1",
"user_limit": "0",
"can_share": "0",
"use_in_acts": "0",
"remark": "33",
"code": "",
"resource": [{
"resource_id": "i_6184ed0a60b2c37884d5181d",
"resource_type": "1",
}]
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码 |
| msg | string | 返回信息 |
| data | object | 返回值 |
返回示例
{
"code": 0,
"msg": "添加成功",
"data": null
}