遍历云备份数据

接口描述

分页查询当前公司下的云备份数据（事件记录），按事件开始时间倒序返回，支持按设备序列号、事件类型、车牌号、时间范围过滤。

请求说明

接口ID 协议 方法 PATH
81 HTTPS GET /openapi/v1/cbs/user/events

PATH参数

无

URL参数

参数 类型 必填 说明
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证
page int 否 页码，从 1 开始，默认 1
size int 否 每页条数，最大 100，默认 20
sn string 否 按设备序列号过滤
type int 否 按事件类型过滤
plate string 否 按车牌号过滤（对关键词字段模糊匹配）
start_time int 否 事件开始时间范围下界（毫秒时间戳）
end_time int 否 事件开始时间范围上界（毫秒时间戳）

HTTP请求头

无特殊要求

请求参数

无（所有参数通过 URL 查询串传递）

请求示例

GET https://open.vzicloud.com/openapi/v1/cbs/user/events?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D&page=1&size=20&sn=12345678-87654321 HTTP/1.1
Host: open.vzicloud.com

返回说明

返回参数

参数 类型 说明
items array 事件列表，按事件开始时间倒序
+ id int 事件 ID
+ sn string 设备序列号
+ bv int 硬件版本号
+ model string 产品型号
+ type int 事件类型
+ level int 事件等级
+ name string 事件名称
+ group_id int 事件组 ID
+ start_time int 事件开始时间戳（秒）
+ begin_time int 视频开始时间戳（秒）
+ end_time int 视频结束时间戳（秒）
+ unique_id string 事件唯一标识
+ image_paths string 图片路径（JSON 数组字符串）
+ keywords string 关键词（车牌号等）
+ content string 事件内容
+ remark string 备注
+ create_time string 创建时间
+ update_time string 更新时间
page int 当前页码
size int 每页条数
total int 总记录数

返回示例

{
  "items": [
    {
      "id": 50001,
      "sn": "12345678-87654321",
      "bv": 1,
      "model": "VAP-100",
      "type": 1,
      "level": 1,
      "name": "motion_detect",
      "group_id": 0,
      "start_time": 1719216000,
      "begin_time": 1719216000,
      "end_time": 1719216060,
      "unique_id": "evt_20260624_001",
      "image_paths": "[\"/2026/06/24/img001.jpg\"]",
      "keywords": "京A12345",
      "content": "{}",
      "remark": "",
      "create_time": "2026-06-24 10:00:00",
      "update_time": "2026-06-24 10:00:00"
    }
  ],
  "page": 1,
  "size": 20,
  "total": 1
}

results matching ""

    No results matching ""