查询云存事件列表

接口描述

若设备开通云备份或云视频功能，臻云将存储设备事件，此接口提供云存事件的查询。

注意：云存储事件不会永久存储，其最大存储条数取决与云备份或云视频的套餐，比如：

  • 如果设备只开通了云备份，云存储空间为500MB，那么这500MB云存储空间能存储多少事件的图片，此接口就能查询到多少事件
  • 如果设备只开通了云视频，存储周期为3天，那么此接口就能查询到3天的事件
  • 如果设备云备份和云视频都开通了，以最多的为主。

图片或视频下载：

请求说明

接口ID 协议 方法 PATH
24 HTTPS GET /openapi/v1/stp/user/devices/events

PATH参数

无

URL参数

参数 类型 必填 说明
size int 否 分页大小，最大值为100
page int 否 页数，最小值为1
wheres string 否 参见WHERES参数
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证

wheres允许填入的k：

参数 类型 说明
sn string 设备的SN
type int 事件类型编号
name string 事件类型名称
start_time int 事件的发生事件，unix时间戳，单位：毫秒
keywords int 关键词，如车牌号码，查询时需要模糊匹配
unique_id string 事件的唯一编码

请求示例

GET https://open.vzicloud.com/openapi/v1/stp/user/devices/events?page=1&size=2&wheres=W3siayI6InNuIiwibyI6ImVxIiwidiI6ImEwOTk0ZWI2LWRlM2RmZWEzIn1d&accesskey_id=SydxcDY163TZ15SZ4cYDJ9Yquk4wlDq9&expires=1736766430&signature=97bFAEg%2FxEMU9DgNHsfvUfJnnjY%3D HTTP/1.1

返回说明

返回参数

参数 类型 说明
size int 当前分页大小
page int 当前分页页码
total int 符合条件的设备总数
items list 事件列表
+ id int ID
+ sn string 设备序列号
+ bv int 设备BoardVersion
+ model string 设备型号
+ type string 事件类型编号
+ name string 事件类型名称
+ start_time int 事件发生时间，Unix时间戳，单位：毫秒
+ begin_time int 事件录像的开始时间，Unix时间戳，单位：秒
+ end_time int 事件录像的结束时间，Unix时间戳，单位：秒
+ unique_id string 事件唯一ID
+ keywords string 关键词数组
+ contents string 事件详细内容
+ create_time string 云端设备信息创建时间，为mysql.timestamp类型
+ update_time string 云端设备信息更新时间，为mysql.timestamp类型
+ remark string 备注

注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！

返回示例

{
  "size": 2,
  "page": 1,
  "total": 27664,
  "items": [
    {
      "content": "{\"barriergate\":[],\"motorvehicle\":[{\"plates\":[{\"binimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"color\":0,\"colorimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"confidence\":0,\"direction\":0,\"is_danger\":0,\"is_fake\":0,\"license\":\"6IuPRTI3SlU5\",\"location\":{\"bottom\":0,\"left\":0,\"right\":0,\"top\":0},\"plate_width\":99,\"regcost\":0,\"type\":0}],\"vehicle\":{\"bgimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"imgs/a0994eb6-de3dfea3/20241214/1734166879_a0994eb6-de3dfea3_0_0_full.jpg\"},\"brandinfo\":{\"brand\":0,\"type\":0,\"year\":0},\"bright\":0,\"color\":0,\"fgimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"location\":{\"bottom\":212,\"left\":464,\"right\":1230,\"top\":31}}}],\"nonmotorvehicle\":[],\"person\":[],\"userdata\":\"\"}",
      "level": 2,
      "name": "stay",
      "bv": 16712,
      "image_paths": "[\"imgs/a0994eb6-de3dfea3/20241214/1734166879_a0994eb6-de3dfea3_0_0_full.jpg\"]",
      "keywords": "[\"苏E27JU9\"]",
      "remark": "",
      "start_time": 1734166879185,
      "model": "",
      "unique_id": "a0994eb6-de3dfea3_1734166879185",
      "id": 102745,
      "sn": "a0994eb6-de3dfea3",
      "group_id": 1,
      "begin_time": 1734166864,
      "end_time": 1734166884,
      "update_time": "2024-12-14 17:01:19.816225",
      "create_time": "2024-12-14 17:01:19.816225",
      "type": 6
    },
    {
      "content": "{\"barriergate\":[],\"motorvehicle\":[{\"plates\":[{\"binimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"color\":0,\"colorimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"confidence\":0,\"direction\":0,\"is_danger\":0,\"is_fake\":0,\"license\":\"6IuPRTI3SlU5\",\"location\":{\"bottom\":0,\"left\":0,\"right\":0,\"top\":0},\"plate_width\":90,\"regcost\":0,\"type\":0}],\"vehicle\":{\"bgimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"imgs/a0994eb6-de3dfea3/20241214/1734166892_a0994eb6-de3dfea3_1_0_full.jpg\"},\"brandinfo\":{\"brand\":0,\"type\":0,\"year\":0},\"bright\":0,\"color\":0,\"fgimg_info\":{\"absolute_path\":\"\",\"relative_path\":\"\"},\"location\":{\"bottom\":212,\"left\":448,\"right\":1216,\"top\":31}}}],\"nonmotorvehicle\":[],\"person\":[],\"userdata\":\"\"}",
      "level": 0,
      "name": "stayend",
      "bv": 16712,
      "image_paths": "[\"imgs/a0994eb6-de3dfea3/20241214/1734166892_a0994eb6-de3dfea3_1_0_full.jpg\"]",
      "keywords": "[\"苏E27JU9\"]",
      "remark": "",
      "start_time": 1734166892939,
      "model": "",
      "unique_id": "a0994eb6-de3dfea3_1734166892939",
      "id": 102746,
      "sn": "a0994eb6-de3dfea3",
      "group_id": 1,
      "begin_time": 0,
      "end_time": 0,
      "update_time": "2024-12-14 17:01:33.083392",
      "create_time": "2024-12-14 17:01:33.083392",
      "type": 13
    }
  ]
}

results matching ""

    No results matching ""