编辑一张优惠劵

接口描述：

  • 编辑一张优惠劵。

请求 URL：

  • http|https://host/api/v1/coupon/method/set.coupon.item/

请求方式：

  • GET
  • POST

是否授权：

  • 需要授权

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
coupon_id integer 是 gt:0 2 优惠劵编号
name string 否 max:50 六一快乐 优惠劵名称
description string 否 max:255 活动描述 优惠劵描述
guide string 否 max:255 //careyshop.cn 优惠劵引导地址
money number 否 gt:0 100 优惠金额
quota number 否 egt:0 1000 限制使用金额(0则不限)
category array 否 gt[]:0 [1,2,3] 限制商品类目
exclude_category array 否 gt[]:0 [5,6,7] 排除商品类目
level array 否 gt[]:0 [] 限制会员等级
frequency integer 否 between:0,255 1 限制领取次数(0则不限)
give_num integer 否 gt:0 2000 发放数量
give_begin_time datetime 否 date 2018-05-22 10:11:00 发放开始时间
give_end_time datetime 否 date 2018-06-05 00:00:00 发放结束时间
use_begin_time datetime 否 date 2018-06-01 00:00:00 使用开始时间
use_end_time datetime 否 date 2018-06-02 00:00:00 使用结束时间
status integer 否 in:0,1 1 优惠劵状态 0=禁用 1=启用
is_invalid integer 否 in:0,1 0 优惠劵是否作废 0=正常 1=作废

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data object 是 [] 返回对象
data 类型 是否返回 示例值 描述
coupon_id integer 是 2 优惠劵编号
name string 否 六一快乐 优惠劵名称
description string 否 活动描述 优惠劵描述
guide string 否 //careyshop.cn 优惠劵引导地址
money number 否 100 优惠金额
quota number 否 1000 限制使用金额(0则不限)
category array 否 ["1","2","3"] 限制商品类目
exclude_category array 否 ["5","6","7"] 排除商品类目
level array 否 [] 限制会员等级
frequency integer 否 1 限制领取次数(0则不限)
give_num integer 否 2000 发放数量
give_begin_time datetime 否 2018-05-22 10:11:00 发放开始时间
give_end_time datetime 否 2018-06-05 00:00:00 发放结束时间
use_begin_time datetime 否 2018-06-01 00:00:00 使用开始时间
use_end_time datetime 否 2018-06-02 00:00:00 使用结束时间
status integer 否 1 优惠劵状态 0=禁用 1=启用
is_invalid integer 否 0 优惠劵是否作废 0=正常 1=作废

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": {
  5.     "coupon_id": 2,
  6.     "name": "六一快乐",
  7.     "description": "活动描述",
  8.     "guide": "//careyshop.cn",
  9.     "money": 100,
  10.     "quota": 1000,
  11.     "category": [
  12.       "1",
  13.       "2",
  14.       "3"
  15.     ],
  16.     "exclude_category": [
  17.       "5",
  18.       "6",
  19.       "7"
  20.     ],
  21.     "level": [],
  22.     "frequency": 1,
  23.     "give_num": 2000,
  24.     "give_begin_time": "2018-05-22 10:11:00",
  25.     "give_end_time": "2018-06-05 00:00:00",
  26.     "use_begin_time": "2018-06-01 00:00:00",
  27.     "use_end_time": "2018-06-02 00:00:00",
  28.     "status": 1,
  29.     "is_invalid": 0
  30.   }
  31. }

备注:

  1. 业务参数是否必须一栏中被标注为否时，可不填写此参数，表示该接口可单独修改某个字段。