简要描述
请求url
https://www.商城域名.com/index.php?s=/api/bargain.task/list
请求方式
是否需授权登录
请求header
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
当前请求的客户端(APP、小程序、H5等) |
Access-Token |
string |
选填 |
- |
当前登录用户的 Token |
请求参数
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
page |
int |
选填 |
1 |
当前页码 |
返回示例
{
"status": 200,
"message": "success",
"data": {
"list": {
"total": 2,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"active_id": 10004,
"goods_id": 10020,
"start_time": "2021-07-01 00:00:00",
"end_time": "2022-07-30 00:00:00",
"expiryt_time": 2,
"floor_price": "1.00",
"is_floor_buy": 0,
"share_title": "麻烦帮我砍一刀!我真的很想要了,爱你哟!(๑′ᴗ‵๑)",
"prompt_words": "\"朋友一生一起走,帮砍一刀有没有\"",
"status": 1,
"active_sales": 127,
"goods": {},
"goods_name": "耐克 男子 NIKE AIR FORCE 1'07 运动鞋",
"goods_image": "b72822760ccc4bb892cc658b33af939e.jpg",
"original_price": "599.00",
"helpList": [],
"helpsCount": 0,
"is_start": true,
"is_end": false
},
{
"active_id": 10007,
"goods_id": 10018,
"start_time": "2022-02-28 14:41:20",
"end_time": "2022-03-07 14:41:20",
"expiryt_time": 2,
"floor_price": "9.90",
"is_floor_buy": 1,
"share_title": "麻烦帮我砍一刀!我真的很想要了,爱你哟!(๑′ᴗ‵๑)",
"prompt_words": "\"朋友一生一起走,帮砍一刀有没有\"",
"status": 1,
"active_sales": 0,
"goods": {},
"goods_name": "简约风条纹客厅沙发卧室床头抱枕靠垫套",
"goods_image": "41cdb778199f99ebebb6090680f382fc.png",
"original_price": "49.90",
"helpList": [
{
"user_id": 10125,
"user": {
"user_id": 10125,
"nick_name": "昔年",
"avatar_id": 10738,
"avatar_url": "230b880c338df99ffbdd502b42ca7dce.png"
}
}
],
"helpsCount": 1,
"is_start": true,
"is_end": false
}
]
}
}
}
返回参数
参数名 |
类型 |
示例值 |
说明 |
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 参数
参数名 |
类型 |
示例值 |
说明 |
active_id |
int |
10004 |
活动ID |
goods_id |
int |
10020 |
砍价活动ID |
start_time |
string |
2021-07-01 00:00:00 |
活动开始时间 |
end_time |
string |
2022-07-30 00:00:00 |
活动结束时间 |
expiryt_time |
int |
2 |
砍价有效期 (单位:小时) |
floor_price |
string |
1.00 |
砍价底价 |
is_floor_buy |
int |
0 |
必须底价购买 (0否 1是) |
share_title |
string |
麻烦帮我砍一刀!我真的很想要了,爱你哟!(๑′ᴗ‵๑) |
分享标题 |
prompt_words |
string |
"朋友一生一起走,帮砍一刀有没有" |
砍价助力语 |
status |
int |
1 |
活动状态 (1进行中 0已结束) |
active_sales |
int |
127 |
活动销量(虚拟销量+实际销量) |
goods |
object |
- |
商品信息;可参考 “商品详情(基础)” API |
goods_name |
string |
耐克 男子 NIKE AIR FORCE 1'07 运动鞋 |
商品名称 |
goods_image |
string |
b72822760ccc4bb892cc658b33af939e.jpg |
商品主图URL |
original_price |
string |
599.00 |
商品原价 |
helpList |
array |
- |
砍价助力榜 |
helpsCount |
int |
0 |
正在砍价的助力人数 |
is_start |
boolean |
true |
活动是否开始 |
is_end |
boolean |
false |
活动是否结束 |