优惠券列表(领券中心)

简要描述
  • 优惠券列表(领券中心)
请求url
  • https://www.商城域名.com/index.php?s=/api/coupon/list
请求方式
  • GET
是否需授权登录
请求header
参数名 类型 是否必须 示例值 说明
storeId int 必填 10001 商城ID
platform string 必填 H5 当前请求的客户端(APP、小程序、H5等)
Access-Token string 选填 - 当前登录用户的 Token
返回示例
{
  "status": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "coupon_id": 10009,
        "name": "折扣券",
        "coupon_type": 20,
        "reduce_price": "0.00",
        "discount": 8.8,
        "min_price": "200.00",
        "expire_type": 10,
        "expire_day": 7,
        "start_time": null,
        "end_time": null,
        "apply_range": 10,
        "apply_range_config": [],
        "describe": "",
        "sort": 100,
        "is_receive": false,
        "state": {
          "text": "正常",
          "value": 1
        }
      },
      {
        "coupon_id": 10007,
        "name": "满100减10",
        "coupon_type": 10,
        "reduce_price": "10.00",
        "discount": 0,
        "min_price": "100.00",
        "expire_type": 10,
        "expire_day": 999,
        "start_time": null,
        "end_time": null,
        "apply_range": 10,
        "apply_range_config": [],
        "describe": "",
        "sort": 100,
        "is_receive": false,
        "state": {
          "text": "正常",
          "value": 1
        }
      }
    ]
  }
}
返回参数
参数名 类型 示例值 说明
status int 200 请求状态(200:请求成功;500:请求错误/失败)
message string success 请求结果的信息,默认为 success
data object - 返回的业务数据
data 参数
参数名 类型 示例值 说明
list array - 优惠券列表
data.list 参数
参数名 类型 示例值 说明
coupon_id int 10009 优惠券ID
name string 折扣券 优惠券名称
coupon_type int 20 优惠券类型 (10满减券 20折扣券)
reduce_price string 0.00 减免金额(仅满减券)
discount number 8.8 折扣率,0-100(仅折扣券)
min_price string 200.00 最低消费金额
expire_type int 10 到期类型 (10领取后生效 20固定时间)
expire_day int 7 有效天数(expire_type为10)
start_time null null 开始时间(expire_type为20)
end_time null null 结束时间(expire_type为20)
apply_range int 10 适用范围 (10全部商品 20指定商品)
apply_range_config array - 适用范围配置 (json格式)
describe string - 优惠券描述
sort int 100 排序 (数字越小越靠前)
is_receive boolean false 是否已领取(当前登录用户)
state object - 领取状态
data.list.state 参数
参数名 类型 示例值 说明
text string 正常 文字
value int 1