查询设备录像列表
接口描述
提供通过臻云查询设备录像列表的接口。
请求说明
| 接口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位通道编号） |
| 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 | 文件大小 |
返回示例
{
"total": 1,
"items": [
{
"file_size": 3456,
"begin_time": 1726070400,
"end_time": 1726104761
}
]
}