简要描述
请求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 |
状态值 |