直播云

    • 直播云 > API Reference > 服务端 API >流管理 >流列表

    流列表

    最近更新时间：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