接口描述:

  • 获取商品折扣列表。

请求 URL:

  • http|https://host/api/v1/discount/method/get.discount.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
name string max:100 端午 折扣名称
status integer in:0,1 1 折扣状态 0=禁用 1=启用
type integer in:0,1,2,3 0 折扣方式,详见「附属 A」
begin_time datetime date 2018-05-26 00:00:00 折扣开始时间
end_time datetime date 2018-06-26 00:00:00 折扣结束时间
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 15 每页数量
order_type string in:asc,desc desc asc 排序方式
order_field string 见附属 A discount_id status 排序字段

附属 A:
in:promotion_id,name,all_goods,begin_time,end_time,status

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 102 合计计数
items 类型 是否返回 示例值 描述
name string 端午促销 折扣名称
discount_id integer 38 折扣编号
type integer 0 折扣方式,详见「附属 A」
begin_time datetime 2018-05-24 23:00:00 折扣开始时间
end_time datetime 2018-06-24 23:00:00 折扣结束时间
status integer 1 折扣状态 0=禁用 1=启用
discount_goods array [] 折扣商品数组
discount_goods 类型 是否返回 示例值 描述
goods_id integer 4 折扣商品编号
discount number 65 折扣商品折扣额

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "discount_id": 38,
  8. "name": "端午促销",
  9. "type": 0,
  10. "begin_time": "2018-05-24 23:00:00",
  11. "end_time": "2018-06-24 23:00:00",
  12. "status": 1,
  13. "discount_goods": [
  14. {
  15. "goods_id": 13,
  16. "discount": 50
  17. },
  18. {
  19. "goods_id": 4,
  20. "discount": 65
  21. }
  22. ]
  23. },
  24. {
  25. "discount_id": 37,
  26. "name": "优惠劵赠送",
  27. "type": 3,
  28. "begin_time": "2017-12-31 21:47:00",
  29. "end_time": "2018-02-02 00:00:00",
  30. "status": 1,
  31. "discount_goods": [
  32. {
  33. "goods_id": 89,
  34. "discount": 10
  35. },
  36. {
  37. "goods_id": 93,
  38. "discount": 10
  39. }
  40. ]
  41. }
  42. ],
  43. "total_result": 10
  44. }
  45. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-06-21 23:50