Skip to content

直播间列表

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:/Third/Room/getRoomListV2
  • 频率限制:10秒100次

请求参数

参数必选类型描述
pagestring页码,从1开始
page_sizestring每页条数。最大50
push_app_nickstring搜索-直播间标题
is_livingstring搜索-推流状态:1-推流中,2-未推流
live_statestring直播状态:not_lived--未直播,living--直播中,up_coming--预告,not_start--未开始,playback--回放,ended--已结束

排序规则

  • 按直播间创建时间倒序排序(最新创建的直播间排在前面)

请求示例

{
    "page": "1",
    "page_size": "15"
}

响应参数

参数必选类型描述
codestring状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
total_numberstring直播间总数
liststring直播间列表

list 参数结构

参数必选类型描述
room_idnumber直播间id
push_app_nickstring直播间标题
theme_typestring直播间主题类型
live_typestring直播间类型:0-默认,1-婚礼,2-电商,3-年会,4-图片,5-连麦, 6-全景
screen_typestring横竖屏:1-横屏,2-竖屏
start_timestring直播开始时间
end_timestring直播结束时间
app_coverstringweb端直播间封面图
app_cover_mobilestring手机端直播间封面图
app_iconstring微信H5分享封面
applet_iconstring小程序分享封面
is_livingstring推流状态:1-推流中,2-未推流
live_statestring直播状态:not_lived--未直播,living--直播中,up_coming--预告,not_start--未开始,playback--回放,ended--已结束
descriptionstring直播间简介
descstring分享描述
room_urlstring直播间H5观看链接
room_webview_urlstring直播间H5观看链接(小程序webview场景)
g_idint直播间分类id
g_namestring直播间分类名
visit_numberstring热力值

响应示例

json
{
  "code": 200,
  "msg": "",
  "data": {
    "total_number": 70,
    "list": [
      {
        "room_id": 3350,
        "push_app_nick": "直播测试",
        "theme_type": 1,
        "live_type": 0,
        "screen_type": 1,
        "start_time": 20200,
        "end_time": 16400,
        "app_cover": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_cover_mobile": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/app_icon.png",
        "applet_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/applet_icon.png",
        "is_living": 2,
        "live_state": "not_lived",
        "description": "直播简介",
        "desc": "直播间详细介绍与说明",
        "room_url": "http://xx.nuoyun.tv/Watch/666666666",
        "room_webview_url": "http://xx.nuoyun.tv/Watch/666666666",
        "g_id": 0,
        "g_name": "无分类",
        "visit_number": "1000"
      },
      {
        "room_id": 3351,
        "push_app_nick": "婚礼直播",
        "theme_type": 1,
        "live_type": 1,
        "screen_type": 1,
        "start_time": 20200,
        "end_time": 16400,
        "app_cover": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_cover_mobile": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/wedding_app_icon.png",
        "applet_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/wedding_applet_icon.png",
        "is_living": 1,
        "live_state": "living",
        "description": "婚礼直播简介",
        "desc": "婚礼直播间详细介绍与说明",
        "room_url": "http://xx.nuoyun.tv/Watch/666666667",
        "room_webview_url": "http://xx.nuoyun.tv/Watch/666666667",
        "g_id": 1,
        "g_name": "婚礼",
        "visit_number": "5000"
      },
      {
        "room_id": 3352,
        "push_app_nick": "电商直播预告",
        "theme_type": 1,
        "live_type": 2,
        "screen_type": 1,
        "start_time": 20200,
        "end_time": 16400,
        "app_cover": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_cover_mobile": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/ecommerce_app_icon.png",
        "applet_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/ecommerce_applet_icon.png",
        "is_living": 2,
        "live_state": "up_coming",
        "description": "电商直播预告简介",
        "desc": "电商直播间详细介绍与产品说明",
        "room_url": "http://xx.nuoyun.tv/Watch/666666668",
        "room_webview_url": "http://xx.nuoyun.tv/Watch/666666668",
        "g_id": 2,
        "g_name": "电商",
        "visit_number": "2000"
      },
      {
        "room_id": 3353,
        "push_app_nick": "年会直播回放",
        "theme_type": 1,
        "live_type": 3,
        "screen_type": 1,
        "start_time": 20200,
        "end_time": 16400,
        "app_cover": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_cover_mobile": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/DB5C/080705E6E8FE267C6E30933E2EE4DB5C.jpg",
        "app_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/annual_app_icon.png",
        "applet_icon": "https://xxxx.oss-cn-hangzhou.aliyuncs.com/Uploads/AppletImg2023/Icon/annual_applet_icon.png",
        "is_living": 2,
        "live_state": "playback",
        "description": "年会直播回放简介",
        "desc": "年会直播间详细介绍与议程说明",
        "room_url": "http://xx.nuoyun.tv/Watch/666666669",
        "room_webview_url": "http://xx.nuoyun.tv/Watch/666666669",
        "g_id": 3,
        "g_name": "年会",
        "visit_number": "3万"
      }
    ]
  }
}