直播云 > 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":""}

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