优惠券列表（领券中心）

简要描述
  • 优惠券列表（领券中心）
请求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 值