接口描述:

  • 编辑一个订单促销。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
promotion_id integer gt:0 106 促销编号
name string max:100 端午订单促销 促销名称
begin_time datetime date 2018-05-26 15:20:23 促销开始时间
end_time datetime date 2018-06-26 15:20:23 促销结束时间
status integer in:0,1 1 促销状态 0=禁用 1=启用
promotion_item array min[]:1 详见promotion_item 促销方式
promotion_item 类型 是否必须 范围值 默认值 示例值 描述
quota number gt:0 500 促销限额
settings array array 详见settings 促销方式项
settings 类型 是否必须 范围值 默认值 示例值 描述
type integer in:0,1,2,3,4 1 促销方式类型,见附属 A,注意备注
value number gt:0 80 促销方式数值

附属 A:
0=减价 1=打折 2=免邮 3=送积分 4=送优惠劵

promotion_item完整示例:

  1. [
  2. {
  3. "quota": 500,
  4. "settings": [
  5. {
  6. "type": 1,
  7. "value": 80
  8. }
  9. ]
  10. },
  11. {
  12. "quota": 1000,
  13. "settings": [
  14. {
  15. "type": 1,
  16. "value": 70
  17. },
  18. {
  19. "type": 3,
  20. "value": 1000
  21. }
  22. ]
  23. }
  24. ]

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
name string 端午订单促销 促销名称
promotion_id integer 106 促销编号
begin_time datetime 2018-05-26 15:20:23 促销开始时间
end_time datetime 2018-06-26 15:20:23 促销结束时间
status integer 1 促销状态 0=禁用 1=启用
promotion_item array [] 促销方式
promotion_item 类型 是否返回 示例值 描述
quota number 500 促销限额
settings array [] 促销方式项数组
settings 类型 是否返回 示例值 描述
type integer 1 促销方式类型,详见备注
value number 80 促销方式数值

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "promotion_id": 106,
  6. "name": "端午订单促销",
  7. "begin_time": "2018-05-26 15:20:23",
  8. "end_time": "2018-06-26 15:20:23",
  9. "status": 1,
  10. "promotion_item": [
  11. {
  12. "quota": 500,
  13. "settings": [
  14. {
  15. "type": "1",
  16. "value": "80"
  17. }
  18. ]
  19. },
  20. {
  21. "quota": 1000,
  22. "settings": [
  23. {
  24. "type": "1",
  25. "value": "70"
  26. },
  27. {
  28. "type": "3",
  29. "value": "1000"
  30. }
  31. ]
  32. }
  33. ]
  34. }
  35. }

备注:

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

  2. 请参考「添加一个订单促销」中的备注说明。

文档更新时间: 2018-05-26 18:09