直播云

  • 流列表

    最近更新时间:2018-05-21 10:54:24

    查询直播空间中的流列表。

    请求包

    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 直播空间名
    liveonly 布尔值,true 表示查询的是正在直播的流,不指定表示返回所有的流。
    prefix 字符串,限定只返回带以 prefix 为前缀的流名,不指定表示不限定前缀。
    limit 整数,限定返回的流个数,不指定表示遵从系统限定的最大个数。
    marker 字符串,上一次查询返回的标记,用于提示服务端从上一次查到的位置继续查询,不指定表示从头查询。

    返回包

    200 {
        "items": [
            {
                "key": "<StreamKey>"
            },
            ...
        ],
        "marker": "<Marker>"
    }
    
    400 {
        "erorr": "bad request"
    }
    
    参数名称 说明
    items 数组,流列表,数组的元素是结构体,key 字段是流名。
    marker 字符串,此次遍历到的标记,用于下次遍历提示起始位置,"" 表示已经查询完所有。

    示例

    请求包:

    GET /v2/hubs/PiliSDKTest/streams?liveonly=true&prefix=&limit=0&marker= HTTP/1.1
    Host: pili.qiniuapi.com
    User-Agent: pili-sdk-go/v2 go1.6 darwin/amd64
    Authorization: Qiniu 7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:2yUFC3JxA1qKgsLcb4_JVlzcEQg=
    Content-Type: application/x-www-form-urlencoded
    Accept-Encoding: gzip
    

    返回包:

    HTTP/1.1 200 OK
    Content-Length: 44
    Content-Type: application/json
    Date: Wed, 18 May 2016 13:12:52 GMT
    X-Log: PILI:3;PILI-LINA:4
    X-Reqid: 7qsRAMKCJSKvq08U
    
    {"items":[{"key":"carter2000"}],"marker":""}
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close