简要描述
请求url
- https://www.商城域名.com/index.php?s=/api/myCoupon/list
请求方式
是否需授权登录
请求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 | 状态值 |