诺云开放平台

Appearance

直播间列表 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Room/getRoomList/2.0.0
  • 频率限制：10秒100次

请求参数 ​

参数必选类型描述
page是number页码，从1开始
page_size是number每页条数。最大50
push_app_nick否string搜索-直播间标题
is_living否number搜索-推流状态：1-推流中，2-未推流
live_state否string直播状态：not_lived--未直播，living--直播中，up_coming--预告，not_start--未开始，playback--回放，ended--已结束
group_id否number直播间分类ID

排序规则 ​

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

请求示例 ​

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

响应参数 ​

参数必选类型描述
code是string状态码：200-成功，400-失败
msg是string提示信息
data是object消息内容

data 参数结构

参数必选类型描述
total_number是string直播间总数
list是array直播间列表

list 参数结构

参数必选类型描述
room_id是number直播间id
push_app_nick是string直播间标题
theme_type是number直播间主题类型
live_type是number直播间类型：0-视频直播，4-图片直播，5-互动直播，6-全景直播
screen_type是number横竖屏：1-横屏，2-竖屏
start_time是number直播开始时间
end_time是number直播结束时间
app_cover是stringweb端直播间封面图
app_cover_mobile是string手机端直播间封面图
app_icon是string微信H5分享封面
applet_icon是string小程序分享封面
is_living是number推流状态：1-推流中，2-未推流
live_state是string直播状态：not_lived--未直播，living--直播中，up_coming--预告，not_start--未开始，playback--回放，ended--已结束
description是string直播间简介
desc是string分享描述
room_url是string直播间H5观看链接
room_webview_url否string直播间H5观看链接（小程序webview场景）
g_id是number直播间分类id
g_name是string直播间分类名
visit_number是string热力值

响应示例 ​

json
{
  "code": 200,
  "data": {
    "total_number": 13,
    "list": [
      {
        "room_id": 1258246155,
        "push_app_nick": "ces zhiboj",
        "theme_type": 1,
        "live_type": 0,
        "screen_type": 1,
        "start_time": 1754958600,
        "end_time": 1754974800,
        "g_id": 0,
        "g_name": "无分类",
        "app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
        "app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
        "is_living": 2,
        "description": "",
        "app_icon": "",
        "applet_icon": "",
        "desc": "",
        "room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/1258246155",
        "room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/1258246155",
        "live_state": "not_lived",
        "visit_number": "2"
      },
      {
        "room_id": 1456070558,
        "push_app_nick": "子账户创建直播5",
        "theme_type": 1,
        "live_type": 0,
        "screen_type": 1,
        "start_time": 1754958600,
        "end_time": 1754974800,
        "g_id": 0,
        "g_name": "无分类",
        "app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
        "app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
        "is_living": 2,
        "description": "",
        "app_icon": "",
        "applet_icon": "",
        "desc": "",
        "room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/1456070558",
        "room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/1456070558",
        "live_state": "not_lived",
        "visit_number": "7"
      },
      {
        "room_id": 224831078,
        "push_app_nick": "子账户创建直播4",
        "theme_type": 1,
        "live_type": 0,
        "screen_type": 1,
        "start_time": 1754958600,
        "end_time": 1754974800,
        "g_id": 0,
        "g_name": "无分类",
        "app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
        "app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
        "is_living": 2,
        "description": "",
        "app_icon": "",
        "applet_icon": "",
        "desc": "",
        "room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/224831078",
        "room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/224831078",
        "live_state": "not_lived",
        "visit_number": "1"
      }
    ]
  },
  "msg": "Success"
}