查询设备录像列表

接口描述

提供通过臻云查询设备录像列表的接口。

请求说明

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

PATH参数

无

URL参数

参数 类型 必填 说明
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证
sn string 是 设备序列号（国标设备则是设备的国标ID）
type int 是 1：本地录像（国标设备必选1） 2：云存录像
channel string 否 通道号，查询本地录像时是必填的（国标设备通道号使用20位通道编号）
stream string 否 码流号，0：主码流；1：子码流。不传则返回所有码流的录像
begin_time int 是 开始时间（Unix时间戳，秒）
end_time int 是 结束时间（Unix时间戳，秒）

注意：

  • begin_time和end_time组成时间段必须在一个自然天内，不允许跨天查询
  • 不支持分页查询

请求示例

GET https://open.vzicloud.com/openapi/v1/stp/user/devices/video/records?sn=51010723991187000001&channel=34020000001320000005&type=1&begin_time=1726070400&end_time=1726104761&accesskey_id=Cedc5EKV6125942kUrpItQIoo9OtMGup&expires=1726111980&signature=ropYf130WqQ6VTOrpRfscx8hlw0%3D HTTP/1.1
Host: open.vzicloud.com

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

返回说明

返回参数

参数 类型 说明
total int 录像总数
items list 通道列表
+ begin_time int 开始时间（Unix时间戳，秒）
+ end_time int 结束时间（Unix时间戳，秒）
+ file_size int 文件大小
+ stream string 码流号（"0"主码流/"1"子码流），可作为「获取录像回放地址」「获取录像下载地址」的 stream 入参
+ event_type string 事件类型（如 4294967295 表示连续录像），可作为「获取录像回放地址」「获取录像下载地址」的 event_type 入参，精确指定某段录像

返回示例

{
  "total": 1,
  "items": [
    {
      "file_size": 3456,
      "begin_time": 1726070400,
      "end_time": 1726104761,
      "stream": "0",
      "event_type": "4294967295"
    }
  ]
}

results matching ""

    No results matching ""