簡要描述
請求url
https://www.商城域名.com/index.php?s=/api/goods/list
請求方式
是否需授權登錄
請求header
參數名 |
類型 |
是否必須 |
示例值 |
說明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
當前請求的客戶端(APP、小程序、H5等) |
Access-Token |
string |
選填 |
- |
當前登錄用戶的 Token |
請求參數
參數名 |
類型 |
是否必須 |
示例值 |
說明 |
categoryId |
int |
選填 |
- |
商品分類ID |
goodsName |
string |
選填 |
- |
商品名稱 (用于搜索) |
goodsNo |
string |
選填 |
- |
商品編碼 |
sortType |
string |
選填 |
all |
排序類型 (all默認 sales銷量 price價格) |
sortPrice |
boolean |
選填 |
true |
價格排序 (true高到低 false低到高) |
返回示例
{
"status": 200,
"message": "success",
"data": {
"list": {
"total": 2,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"goods_sales": 363,
"goods_id": 10007,
"goods_name": "小米6X 全網通 4GB+32GB 流沙金 移動聯通電信4G手機 雙卡雙待 智能手機",
"goods_no": "",
"video_id": 0,
"video_cover_id": 0,
"selling_point": "",
"spec_type": 20,
"goods_price_min": "1371.02",
"goods_price_max": "1665.02",
"line_price_min": "0.00",
"line_price_max": "0.00",
"stock_total": 1994,
"delivery_id": 10001,
"is_points_gift": 1,
"is_points_discount": 1,
"is_alone_points_discount": 0,
"points_discount_config": "",
"is_enable_grade": 1,
"is_alone_grade": 0,
"alone_grade_equity": [],
"status": 10,
"is_ind_dealer": 0,
"dealer_money_type": 10,
"first_money": "0.00",
"second_money": "0.00",
"third_money": "0.00",
"goods_image": "http://static.yoshop.xany6.com/2018071716542894aea9466.jpg",
"is_user_grade": true
}
]
}
}
}
返回參數
參數名 |
類型 |
示例值 |
說明 |
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 參數
參數名 |
類型 |
示例值 |
說明 |
goods_sales |
int |
363 |
顯示銷量 (初始銷量 + 實際銷量) |
goods_id |
int |
10007 |
商品ID |
goods_name |
string |
小米6X 全網通4G+32G.... |
商品名稱 |
goods_no |
string |
- |
商品編碼 |
video_id |
int |
- |
主圖視頻ID |
video_cover_id |
int |
- |
主圖視頻封面ID |
selling_point |
string |
- |
商品賣點 |
spec_type |
int |
20 |
商品規格 (10單規格 20多規格) |
goods_price_min |
string |
1371.02 |
商品價格 (最低) |
goods_price_max |
string |
1665.02 |
商品價格 (最高) |
line_price_min |
string |
0.00 |
劃線價格 (最低) |
line_price_max |
string |
0.00 |
劃線價格 (最高) |
stock_total |
int |
1994 |
庫存總量 (包含所有sku) |
delivery_id |
int |
10001 |
配送模板ID |
is_points_gift |
int |
1 |
是否開啟積分贈送 (1開啟 0關閉) |
is_points_discount |
int |
1 |
是否允許使用積分抵扣 (1允許 0不允許) |
is_enable_grade |
int |
1 |
是否開啟會員折扣 (1開啟 0關閉) |
is_alone_grade |
int |
- |
會員折扣設置 (0默認等級折扣 1單獨設置折扣) |
alone_grade_equity |
array |
- |
單獨設置折扣的配置 |
status |
int |
10 |
商品狀態 (10上架 20下架) |
is_ind_dealer |
int |
- |
是否開啟單獨分銷 (0關閉 1開啟) |
dealer_money_type |
int |
10 |
分銷傭金類型 (10百分比 20固定金額) |
first_money |
string |
0.00 |
分銷傭金 (一級) |
second_money |
string |
0.00 |
分銷傭金 (二級) |
third_money |
string |
0.00 |
分銷傭金 (三級) |
goods_image |
string |
2018071716542894aea9466.jpg |
商品主圖url |
is_user_grade |
boolean |
true |
是否使用會員等級折扣價(判斷登錄用戶的會員等級) |