我的優(yōu)惠券列表

簡(jiǎn)要描述
  • 獲取當(dāng)前用戶的優(yōu)惠券列表
請(qǐng)求url
  • https://www.商城域名.com/index.php?s=/api/myCoupon/list
請(qǐng)求方式
  • GET
是否需授權(quán)登錄
  • 是
請(qǐng)求header
參數(shù)名 類型 是否必須 示例值 說(shuō)明
storeId int 必填 10001 商城ID
platform string 必填 H5 當(dāng)前請(qǐng)求的客戶端（APP、小程序、H5等）
Access-Token string 選填 - 當(dāng)前登錄用戶的 Token
請(qǐng)求參數(shù)
參數(shù)名 類型 是否必須 示例值 說(shuō)明
dataType string 必填 isUnused 數(shù)據(jù)類型（all全部 isUsable可用的 isExpire已過(guò)期 isUse已使用）
page int 選填 1 當(dāng)前頁(yè)碼
返回示例
{
  "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
          }
        }
      ]
    }
  }
}
返回參數(shù)
參數(shù)名 類型 示例值 說(shuō)明
status int 200 請(qǐng)求狀態(tài)（200：請(qǐng)求成功；500：請(qǐng)求錯(cuò)誤/失敗）
message string success 請(qǐng)求結(jié)果的信息，默認(rèn)為 success
data object - 返回的業(yè)務(wù)數(shù)據(jù)
data 參數(shù)
參數(shù)名 類型 示例值 說(shuō)明
list object - 列表數(shù)據(jù)
data.list 參數(shù)
參數(shù)名 類型 示例值 說(shuō)明
total int 2 總記錄數(shù)
per_page int 15 每頁(yè)條數(shù)
current_page int 1 當(dāng)前頁(yè)碼
last_page int 1 最后頁(yè)碼
data array - 列表數(shù)組
data.list.data 參數(shù)
參數(shù)名 類型 示例值 說(shuō)明
user_coupon_id int 34 ID
coupon_id int 10009 優(yōu)惠券ID
name string 折扣券 優(yōu)惠券名稱
coupon_type int 20 優(yōu)惠券類型 (10滿減券 20折扣券)
reduce_price string 0.00 減免金額（僅滿減券）
discount number 8.8 折扣率，0-100（僅折扣券）
min_price string 200.00 最低消費(fèi)金額
expire_type int 10 到期類型 (10領(lǐng)取后生效 20固定時(shí)間)
expire_day int 7 有效天數(shù)（expire_type為10）
start_time string 2022/02/25 開始時(shí)間
end_time string 2022/03/04 結(jié)束時(shí)間
apply_range int 10 適用范圍 (10全部商品 20指定商品)
apply_range_config array - 適用范圍配置(json格式)
is_expire int - 是否過(guò)期 (0未過(guò)期 1已過(guò)期)
is_use int - 是否已使用 (0未使用 1已使用)
user_id int 10125 用戶ID
store_id int 10001 -
state object - 領(lǐng)取狀態(tài)
create_time string 1645780764 領(lǐng)取時(shí)間
data.list.data.state 參數(shù)
參數(shù)名 類型 示例值 說(shuō)明
text string 正常 狀態(tài)文字
value int 1 狀態(tài)值