我的优惠券列表

简要描述
  • 获取当前用户的优惠券列表
请求url
  • https://www.商城域名.com/index.php?s=/api/myCoupon/list
请求方式
  • GET
是否需授权登录
请求header
参数名 类型 是否必须 示例值 说明
storeId int 必填 10001 商城ID
platform string 必填 H5 当前请求的客户端(APP、小程序、H5等)
Access-Token string 选填 - 当前登录用户的 Token
请求参数
参数名 类型 是否必须 示例值 说明
dataType string 必填 isUnused 数据类型(all全部 isUsable可用的 isExpire已过期 isUse已使用)
page int 选填 1 当前页码
返回示例
{
  "status": 200,
  "message": "success",
  "data": {
    "list": {
      "total": 2,
      "per_page": 15,
      "current_page": 1,
      "last_page": 1,
      "data": [
        {
          "user_coupon_id": 34,
          "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": "2022/02/25",
          "end_time": "2022/03/04",
          "apply_range": 10,
          "apply_range_config": [],
          "is_expire": 0,
          "is_use": 0,
          "user_id": 10125,
          "store_id": 10001,
          "create_time": "2022-02-25 17:19:24",
          "update_time": "2022-02-25 17:19:24",
          "state": {
            "text": "正常",
            "value": 1
          }
        },
        {
          "user_coupon_id": 35,
          "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": "2022/02/25",
          "end_time": "2024/11/20",
          "apply_range": 10,
          "apply_range_config": [],
          "is_expire": 0,
          "is_use": 0,
          "user_id": 10125,
          "store_id": 10001,
          "create_time": "2022-02-25 17:20:01",
          "update_time": "2022-02-25 17:20:01",
          "state": {
            "text": "正常",
            "value": 1
          }
        }
      ]
    }
  }
}
返回参数
参数名 类型 示例值 说明
status int 200 请求状态(200:请求成功;500:请求错误/失败)
message string success 请求结果的信息,默认为 success
data object - 返回的业务数据
data 参数
参数名 类型 示例值 说明
list object - 列表数据
data.list 参数
参数名 类型 示例值 说明
total int 2 总记录数
per_page int 15 每页条数
current_page int 1 当前页码
last_page int 1 最后页码
data array - 列表数组
data.list.data 参数
参数名 类型 示例值 说明
user_coupon_id int 34 ID
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 string 2022/02/25 开始时间
end_time string 2022/03/04 结束时间
apply_range int 10 适用范围 (10全部商品 20指定商品)
apply_range_config array - 适用范围配置(json格式)
is_expire int - 是否过期 (0未过期 1已过期)
is_use int - 是否已使用 (0未使用 1已使用)
user_id int 10125 用户ID
store_id int 10001 -
state object - 领取状态
create_time string 1645780764 领取时间
data.list.data.state 参数
参数名 类型 示例值 说明
text string 正常 状态文字
value int 1 状态值