直播云

  • 直播云 > 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 已集成该接口功能,可以更方便的调用,前往下载

    以上内容是否对您有帮助?
  • Qvm free helper
    Close