查询直播空间中的流列表。
请求包
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":""}
文档反馈
(如有产品使用问题,请提交工单)