接口描述:

  • 获取一张优惠劵。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
coupon_id integer gt:0 2 优惠劵编号

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
coupon_id integer 11 优惠劵编号
name string 六一快乐 优惠劵名称
description string 活动描述 优惠劵描述
guide string //careyshop.cn 优惠劵引导地址
type integer 2 优惠劵类型,详见「备注1」
give_code string DjEU0GtU9t 优惠劵领取码
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 发放数量
receive_num integer 0 累计领取数量
use_num integer 0 累计使用数量
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. "type": 2,
  10. "give_code": "lMoajWAEOD",
  11. "money": 100,
  12. "quota": 1000,
  13. "category": [
  14. "1",
  15. "2",
  16. "3"
  17. ],
  18. "exclude_category": [
  19. "5",
  20. "6",
  21. "7"
  22. ],
  23. "level": [],
  24. "frequency": 1,
  25. "give_num": 2000,
  26. "receive_num": 0,
  27. "use_num": 0,
  28. "give_begin_time": "2018-05-22 10:11:00",
  29. "give_end_time": "2018-06-05 00:00:00",
  30. "use_begin_time": "2018-06-01 00:00:00",
  31. "use_end_time": "2018-06-02 00:00:00",
  32. "status": 1,
  33. "is_invalid": 0
  34. }
  35. }

备注:

文档更新时间: 2018-06-15 10:23