Pili 直播 > API 文档 > 直播流管理API >查询直播流列表

查询直播流列表

最近更新时间: 2021-11-02 15:22:10

接口描述

查询目标直播空间下的直播流列表，可以根据直播流在线状态和直播流名称进行筛选

请求参数

GET /v2/hubs/<Hub>/streams?liveonly=<true>&prefix=<prefix>&limit=<limit>&marker=<marker>
Host: pili.qiniuapi.com 
Authorization: <QiniuToken>  
Content-Type: application/x-www-form-urlencoded

名称	类型	是否必须	描述
hub	string	是	直播空间名
liveonly	bool	否	只返回当前在线的流，true 表示查询的是正在直播的流，不指定表示返回所有的流
prefix	string	否	流名称前缀匹配
limit	int	否	返回值数量限制，取值范围0～5000
marker	string	否	游标，表示从该位置开始返回

返回数据

名称	类型	描述
items	object []	直播流列表
├─ key	string	直播流名称
marker	string	游标，表示当前位置，若marker为空，表示遍历完成

示例

请求体:

GET /v2/hubs/test/streams?limit=10&liveonly=true HTTP/1.1
Host: pili.qiniuapi.com 
Authorization: <QiniuToken> 
Content-Type: application/x-www-form-urlencoded

返回体:

200 OK

{
    "items": [
        {
            "key": "stream1"
        }, 
        {
            "key": "stream2"
        },
        {
            "key": "stream3"
        }
    ],
    "marker": "" 
}

SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往下载

以上内容是否对您有帮助？