接口描述:

  • 获取正在进行的促销列表。

请求 URL:

  • http|https://host/api/v1/promotion/method/get.promotion.active/

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
promotion_id integer 106 促销编号
name string 端午订单促销 促销名称
begin_time datetime 2018-05-26 15:20:23 促销开始时间
end_time datetime 2018-06-26 15:20:23 促销结束时间
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. "promotion_item": [
  10. {
  11. "quota": 1000,
  12. "settings": [
  13. {
  14. "type": "1",
  15. "value": "70"
  16. },
  17. {
  18. "type": "3",
  19. "value": "1000"
  20. }
  21. ]
  22. },
  23. {
  24. "quota": 500,
  25. "settings": [
  26. {
  27. "type": "1",
  28. "value": "80"
  29. }
  30. ]
  31. }
  32. ]
  33. }
  34. }

备注:

  1. 一个订单促销活动可以有多个促销方式,并且每个促销方式下面可以有多个促销方式项

  2. 参数type值的不同,对应参数value的作用就不同。

    • type=0时,value的作用是在原价的基础上减去value值。
    • type=1时,value的作用是按value的值进行打折(80表示8折)计算。
    • type=2时,value的作用是该笔订单免邮,此时value的值可以填0
    • type=3时,value的作用是订单完成后额外赠送value值的积分。
    • type=4时,value的作用是订单完成后赠送value值的优惠劵(等同于coupon_id=65)。
文档更新时间: 2018-06-21 17:10