简要描述
请求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 |
是否使用会员等级折扣价(判断登录用户的会员等级) |