获取视频地址
接口描述
获取设备视频的实时直播地址，目前支持FLV、RTSP，要能够成功访问此接口并得到播放地址有几下几个条件：
- 该设备已经被绑定到你的账号下
- 设备支持此功能（请与臻识销售咨询您的设备是否支持）
请求说明
| 协议 | 方法 | PATH |
|---|---|---|
| HTTPS | GET | /openapi/v1/stp/user/devices/vurl |
PATH参数
无
URL参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accesskey_id | string | 是 | 参见签名认证 |
| expires | int | 是 | 参见签名认证 |
| signature | string | 是 | 参见签名认证 |
| sn | string | 是 | 设备序列号 |
| type | string | 是 | 播放地址类型，可选值有 auto、 rtsp、flv、mjpeg |
| proto | string | 否 | 视频协议，设置返回flv的协议，可选值有http、ws，若不传此参数，那么设备支持http-flv则返回http-flv，否则返回ws-flv |
| auth | string | 否 | 认证信息，默认为admin:admin的Base64编码 |
| user_tag | string | 否 | 用户标识，可以用于管理取流，1到16位的数字和字母组合 |
注1：建议在浏览器、移动端播放时使用flv，在PC客户端使用rtsp。
注2: 若在浏览器、移动端播放时建议使用auto类型，此类型会自动判断所访问设备所支持的流类型，若设备支持flv，则返回flv的播放地址，否则返回mjpeg的播放地址（注意此类型不会返回rtsp的播放地址）
注3：不建议使用mjpeg，此类型的支持只是为了保证从旧臻云到新臻云的过渡，新臻云后期会禁用此类型
注4：如果type为flv且设备端开启了认证，那么需要传入auth信息才能成功播放视频，如下图：
auth认证信息是设备登录名和密码的username:password的Base64编码，若不传，臻云会使用臻云控制台配置的登录名和密码，如下图：
如果臻云控制台没有配置设备的登录名和密码，臻云会默认使用admin:admin作为认证信息。
注5：同一台的设备的用户标识必须唯一，否则新的用户标识会取代旧的用户标识
请求示例
GET https://open.vzicloud.com/openapi/v1/stp/user/devices/vurl?sn=6593d05e-34c85fbd&type=auto&accesskey_id=7eQ8kIcf1125fDVz4dnBJhMh7n9tSGGy&expires=1600763374&signature=mGZdL636IzUyw5zpBppYSinwAOc%3D HTTP/1.1
Host: open.vzicloud.com
注意：您无法将请求示例的链接地址贴入浏览器直接运行，此示例仅展示URL格式，由于AccessKey具备有效期，您访问时此链接已过期。
返回说明
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| type | string | 播放地址类型，可选值有 rtsp、flv、mjpeg |
| url | string | 播放地址 |
注意：接口返回的url包含有效期，请千万不要将返回的url存储长期使用，否则有效期过了将无法播放视频。
返回示例
{
"type": "flv",
"proto": "http",
"url": "https://video2.vzicloud.com/stream.flv?target=_7R3Mm7PsmpoIqJP1IKMvBEUyGtW4oo7ayUZRgXJx6ph3TSMuKtXYkznA0KqGeZkn7e3XJrY_GIlshfrpxAZUklRNl8jdK22VP9XGO7LITO048d7kmTPS35ax2fJqj4G"
}