简要描述
请求url
https://www.商城域名.com/index.php?s=/api/sharp.goods/list
请求方式
是否需授权登录
请求header
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
当前请求的客户端(APP、小程序、H5等) |
Access-Token |
string |
选填 |
- |
当前登录用户的 Token |
请求参数
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
activeTimeId |
int |
必填 |
10121 |
秒杀场次ID |
page |
int |
选填 |
1 |
当前页码 |
返回示例
{
"status": 200,
"message": "success",
"data": {
"list": {
"total": 1,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"sharp_goods_id": 10028,
"goods_id": 10018,
"spec_type": 10,
"seckill_price_min": "12.90",
"seckill_price_max": "12.90",
"deduct_stock_type": 10,
"limit_num": 999,
"seckill_stock": 99,
"goods_name": "简约风条纹客厅沙发卧室床头抱枕靠垫套",
"goods_image": "41cdb778199f99ebebb6090680f382fc.png",
"original_price": "49.90",
"sales_actual": 32,
"progress": 32
}
]
}
}
}
返回参数
参数名 |
类型 |
示例值 |
说明 |
status |
int |
200 |
请求状态(200:请求成功;500:请求错误/失败) |
message |
string |
success |
请求结果的信息,默认为 success |
data |
object |
- |
返回的业务数据 |
data 参数
参数名 |
类型 |
示例值 |
说明 |
list |
object |
- |
秒杀商品列表 |
data.list 参数
参数名 |
类型 |
示例值 |
说明 |
total |
int |
1 |
总记录数 |
per_page |
int |
15 |
每页数量 |
current_page |
int |
1 |
当前页码 |
last_page |
int |
1 |
最后页码 |
data |
array |
- |
列表数据 |
data.list.data 参数
参数名 |
类型 |
示例值 |
说明 |
sharp_goods_id |
int |
10028 |
秒杀商品ID |
goods_id |
int |
10018 |
商品ID |
spec_type |
int |
10 |
商品规格 (10单规格 20多规格) |
seckill_price_min |
string |
12.90 |
秒杀价格 (最低) |
seckill_price_max |
string |
12.90 |
秒杀价格 (最高) |
deduct_stock_type |
int |
10 |
库存计算方式 (仅支持下单减库存) |
limit_num |
int |
999 |
限购数量 (0为不限制) |
seckill_stock |
int |
99 |
商品库存总量 |
goods_name |
string |
简约风条纹客厅沙发卧室床头抱枕靠垫套 |
商品名称/标题 |
goods_image |
string |
41cdb778199f99ebebb6090680f382fc.png |
排序 (数字越小越靠前) |
original_price |
string |
49.90 |
商品原价 |
sales_actual |
int |
32 |
显示销量(初始销量+实际销量) |
progress |
int |
32 |
秒杀进度(0%-100%) |