获取取流详情
接口描述
获取当前公司或指定用户标识的取流详情,其中包括如下信息:
- 当前正在取流的设备列表
- 当前取流所占用的总带宽
- 当前取流的总画面数
- 每台设备占用的总带宽
- 每台设备取流的总画面数
请求说明
接口ID | 协议 | 方法 | PATH |
---|---|---|---|
13 | HTTPS | GET | /openapi/v1/stp/user/devices/video/detail |
PATH参数
无
URL参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
accesskey_id | string | 是 | 参见签名认证 |
expires | int | 是 | 参见签名认证 |
signature | string | 是 | 参见签名认证 |
user_tag | string | 否 | 获取视频地址时指定的用户标识 |
注:若不传user_tag参数,会返回该公司所有正在取流的设备取流情况;若传入user_tag参数,会返回与传入参数相同用户标识的设备取流情况
请求示例
GET https://open.vzicloud.com/openapi/v1/stp/user/devices/video/detail?user_tag=111&accesskey_id=8dlP5tsD2115Q2ec9fCkX2wHSIIlhCO8&expires=1638240891&signature=WH4sif5GAjaiivX0moBP7FcP8Kg%3D HTTP/1.1
Host: open.vzicloud.com
注意:您无法将请求示例的链接地址贴入浏览器直接运行,此示例仅展示URL格式,由于AccessKey具备有效期,您访问时此链接已过期。
返回说明
返回参数
参数 | 类型 | 说明 |
---|---|---|
bandwidth | float | 当前取流所占用的总带宽,单位:Mbps |
concurrency | int | 当前取流的总画面数,单位:个 |
items | array | 当前正在取流的设备列表 |
+ sn | string | 设备序列号 |
+ user_tag | string | 用户标识 |
+ bandwidth | float | 当前设备所占用的总带宽,单位:Mbps |
+ concurrency | int | 当前设备取流的总画面数,单位:个 |
返回示例
{
"bandwidth": 0.5,
"concurrency": 1,
"items": [
{
"sn": "12345678-87654321",
"user_tag": "",
"bandwidth": 0.5,
"concurrency": 1
},
{
"sn": "12345678-87654322",
"user_tag": "",
"bandwidth": 0,
"concurrency": 0
}
]
}