获取录像回放地址
接口描述
获取设备录像回放地址，要能够成功访问此接口并得到播放地址有几下几个条件：
- 该设备已经被绑定到你的账号下
- 设备支持此功能（请与臻识销售咨询您的设备是否支持）
请求说明
| 接口ID | 协议 | 方法 | PATH |
|---|---|---|---|
| 21 | HTTPS | GET | /openapi/v1/stp/user/devices/video/record_url |
PATH参数
无
URL参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accesskey_id | string | 是 | 参见签名认证 |
| expires | int | 是 | 参见签名认证 |
| signature | string | 是 | 参见签名认证 |
| sn | string | 是 | 设备序列号 |
| type | string | 是 | 1：本地录像（国标设备必选1） 2：云存录像 0：自动（优先查询云存录像） |
| channel | string | 否 | 通道号，当type为0和1时必填 （国标设备通道号使用20位通道编号） |
| begin_time | int | 是 | 开始时间（Unix时间戳，秒） |
| end_time | int | 是 | 结束时间（Unix时间戳，秒） |
| unique_id | string | 否 | 事件唯一ID，当type为0和2时必填 |
注意：本地录像返回http-flv类型的地址，云存录像返回hls(m3u8)类型的地址
请求示例
GET https://open.vzicloud.com/openapi/v1/stp/user/devices/video/record_url?sn=51010723991187000001&channel=34020000001320000005&type=1&begin_time=1726070400&end_time=1726104761&accesskey_id=Cedc5EKV6125942kUrpItQIoo9OtMGup&expires=1726113130&signature=SKe6%2B2EqK4KgwHDhkKbc1z7e7iA%3D HTTP/1.1
Host: open.vzicloud.com
注意：您无法将请求示例的链接地址贴入浏览器直接运行，此示例仅展示URL格式，由于AccessKey具备有效期，您访问时此链接已过期。
返回说明
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| url | string | 播放地址 |
| proto | string | 本地录像固定为flv; 云存录像返回hls |
注意：接口返回的url包含有效期，请千万不要将返回的url存储长期使用，否则有效期过了将无法播放视频。
返回示例
{
"proto": "flv",
"url": "https://video4.vzicloud.com:9080/flv/51010723991187000001/rec/34020000001320000005/1726070400-1726104761.flv?exp=1726106530&n=228037122&sid=17261059300100132675&signature=ZsAYCdaSdloiWnhF-FJvNxxOuMU"
}