簡(jiǎn)要描述
- 砍價(jià)活動(dòng)會(huì)場(chǎng)列表
請(qǐng)求url
https://www.商城域名.com/index.php?s=/api/bargain.active/list
請(qǐng)求方式
是否需授權(quán)登錄
請(qǐng)求header
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
當(dāng)前請(qǐng)求的客戶端(APP、小程序、H5等) |
Access-Token |
string |
選填 |
- |
當(dāng)前登錄用戶的 Token |
請(qǐng)求參數(shù)
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
page |
int |
選填 |
1 |
當(dāng)前頁碼 |
返回示例
{
"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",
"peoples": 2,
"is_self_cut": 1,
"is_floor_buy": 0,
"share_title": "麻煩幫我砍一刀!我真的很想要了,愛你喲!(?′?‵?)",
"prompt_words": "\"朋友一生一起走,幫砍一刀有沒有\(zhòng)"",
"actual_sales": 4,
"initial_sales": 123,
"status": 1,
"active_sales": 127,
"goods": {},
"goods_name": "耐克 男子 NIKE AIR FORCE 1'07 運(yùn)動(dòng)鞋",
"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",
"peoples": 5,
"is_self_cut": 1,
"is_floor_buy": 1,
"share_title": "麻煩幫我砍一刀!我真的很想要了,愛你喲!(?′?‵?)",
"prompt_words": "\"朋友一生一起走,幫砍一刀有沒有\(zhòng)"",
"actual_sales": 0,
"initial_sales": 0,
"status": 1,
"active_sales": 0,
"goods": {},
"goods_name": "簡(jiǎn)約風(fēng)條紋客廳沙發(fā)臥室床頭抱枕靠墊套",
"goods_image": "41cdb778199f99ebebb6090680f382fc.png",
"original_price": "49.90",
"helpList": [],
"helpsCount": 0,
"is_start": true,
"is_end": false
}
]
}
}
}
返回參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
status |
int |
200 |
請(qǐng)求狀態(tài)(200:請(qǐng)求成功;500:請(qǐng)求錯(cuò)誤/失?。?/td>
|
message |
string |
success |
請(qǐng)求結(jié)果的信息,默認(rèn)為 success |
data |
object |
- |
返回的業(yè)務(wù)數(shù)據(jù) |
data 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
list |
object |
- |
列表數(shù)據(jù) |
data.list 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
total |
int |
2 |
總記錄數(shù) |
per_page |
int |
15 |
每頁條數(shù) |
current_page |
int |
1 |
當(dāng)前頁碼 |
last_page |
int |
1 |
最后頁碼 |
data |
array |
- |
列表數(shù)組 |
data.list.data 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
active_id |
int |
10004 |
砍價(jià)活動(dòng)ID |
goods_id |
int |
10020 |
商品ID |
start_time |
string |
2021-07-01 00:00:00 |
活動(dòng)開始時(shí)間 |
end_time |
string |
2022-07-30 00:00:00 |
活動(dòng)結(jié)束時(shí)間 |
expiryt_time |
int |
2 |
砍價(jià)有效期 (單位:小時(shí)) |
floor_price |
number |
1.00 |
砍價(jià)底價(jià) |
peoples |
int |
2 |
幫砍人數(shù) |
is_self_cut |
int |
1 |
可自砍一刀 (0禁止 1允許) |
is_floor_buy |
int |
0 |
必須底價(jià)購(gòu)買 (0否 1是) |
share_title |
string |
麻煩幫我砍一刀!我真的很想要了,愛你喲!(?′?‵?) |
分享標(biāo)題 |
prompt_words |
string |
"朋友一生一起走,幫砍一刀有沒有" |
砍價(jià)助力語 |
status |
int |
1 |
活動(dòng)狀態(tài) (1進(jìn)行中 0已結(jié)束) |
active_sales |
int |
127 |
活動(dòng)銷量(虛擬銷量+實(shí)際銷量) |
goods |
object |
- |
主商品信息;可參考“商品詳情(基礎(chǔ))”API |
goods_name |
string |
耐克 男子 NIKE AIR FORCE 1'07 運(yùn)動(dòng)鞋 |
商品名稱 |
goods_image |
string |
b72822760ccc4bb892cc658b33af939e.jpg |
商品主圖URL |
original_price |
string |
599.00 |
商品原價(jià) |
helpList |
array |
- |
砍價(jià)助力榜 |
helpsCount |
int |
0 |
正在砍價(jià)的助力人數(shù) |
is_start |
boolean |
true |
活動(dòng)是否開始 |
is_end |
boolean |
false |
活動(dòng)是否結(jié)束 |