获取录像下载地址

接口描述

获取云视频的事件录像下载地址，暂不支持下载设备本地录像，开通云视频请咨询销售。

云视频的事件录像是一个MP4文件，发起下载请求后需要后端服务转码，这需要一定的转码时间。在处于转码状态时，该接口会返回转码进度，可以多次调用该接口查看进度；当转码进度到达100时，返回值中会多出一个url字段，访问即可开始下载文件。

请求说明

接口ID 协议 方法 PATH
23 HTTPS GET /openapi/v1/stp/user/devices/video/record_download_url

PATH参数

无

URL参数

参数 类型 必填 说明
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证
sn string 是 设备序列号
type string 是 1：本地录像（暂不支持） 2：云存录像
begin_time int 是 开始时间（Unix时间戳，秒）
end_time int 是 结束时间（Unix时间戳，秒）
unique_id string 是 事件唯一ID

请求示例

GET https://open.vzicloud.com/openapi/v1/stp/user/devices/video/record_download_url?sn=a0994eb6-de3dfea3&type=2&begin_time=1736759336&end_time=1736759356&unique_id=a0994eb6-de3dfea3_1736759351210&accesskey_id=SydxcDY163TZ15SZ4cYDJ9Yquk4wlDq9&expires=1736766708&signature=fJ5N5LKbZNC7UaFQlVxBWvOml%2FU%3D HTTP/1.1
Host: open.vzicloud.com

注意：您无法将请求示例的链接地址贴入浏览器直接运行，此示例仅展示URL格式，由于AccessKey具备有效期，您访问时此链接已过期。

返回说明

返回参数

参数 类型 说明
status int 状态，转码时为1，转码结束时为0
progress int 转码进度百分比
url string url，当转码完成时才会有内容

返回示例

// 转码状态时
{
    "status": 1,
    "progress": 10,
    "url": ""
}
// 转码完成时
{
    "status": 0,
    "progress": 100,
    "url": "https://......"
}

results matching ""

    No results matching ""