简要描述
请求url
https://www.商城域名.com/index.php?s=/api/live.room/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": 1,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"id": 1,
"room_id": 13,
"room_name": "全场五折大卖场",
"cover_img": "http://mmbiz.qpic.cn/mmbiz_jpg/vgS1msTHSD9wYWlLnYcBYWsBmJuiccGhv8uUkftzuZC3YYT1VxnKocMtas3CQcXGCIiaHSYkdv1Xh30CV1X8ticGQ/0",
"share_img": "http://mmbiz.qpic.cn/mmbiz_jpg/vgS1msTHSD9wYWlLnYcBYWsBmJuiccGhvjp3Hrz10QST0NM0EDX4EpYkPIldR5dHocKDJgNEsYnWXN5ZWZMKS5g/0",
"anchor_name": "Andy",
"start_time": "03/01 12:00",
"end_time": "03/01 15:00",
"live_status": 102,
"is_top": 0,
"live_status_text_1": "明天12:00 开播",
"live_status_text_2": "未开始"
}
]
}
}
}
返回参数
参数名 |
类型 |
示例值 |
说明 |
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 参数
参数名 |
类型 |
示例值 |
说明 |
id |
int |
1 |
ID |
room_id |
int |
13 |
直播间ID (来源微信) |
room_name |
string |
全场五折大卖场 |
直播间名称 |
cover_img |
string |
- |
分享卡片封面 |
share_img |
string |
- |
直播间背景墙封面 |
anchor_name |
string |
Andy |
主播昵称 |
start_time |
string |
03/01 12:00 |
开播时间 |
end_time |
string |
03/01 15:00 |
结束时间 |
live_status |
int |
102 |
直播状态(101: 直播中, 102: 未开始, 103: 已结束, 104: 禁播, 105: 暂停中, 106: 异常, 107: 已过期) |
is_top |
int |
0 |
置顶状态 (0未置顶 1已置顶) |
live_status_text_1 |
string |
明天12:00 开播 |
直播状态文字1 |
live_status_text_2 |
string |
未开始 |
直播状态文字2 |