获取指定设备录像文件列表
接口功能
获取指定设备录像文件列表,本接口仅支持:设备接入底座是视联网底座。
请求地址
https://open.qly.cmviot.cn/v3/open/api/device/record/list请求方式
POST,需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| deviceSn | String | Y | 设备ID | |
| storageType | String | Y | 存储类型 | 0:云存储 1:设备存储 |
| streamType | int | Y | 码流类型 | 1:主码流,2:辅码流1,3:辅码流2 |
| startTime | Long | Y | 查询开始时间 | 13位时间戳,必填 |
| endTime | Long | Y | 查询结束时间 | 13位时间戳,必填,需晚于开始时间 |
| pageSize | int | N | 每次查询数量 | 默认100,最大100 |
| sort | String | N | 排序 | 按录像开始时间排序:默认为1;1代表降序,2代表升序 |
| sizeWidth | String | N | 缩略图宽度 | 默认320 |
| sizeHeight | String | N | 缩略图高度 | 默认320 |
| effectiveTime | Long | N | 缩略图地址有效时间 | 单位秒、默认600 |
| channelId | int | N | 通道号 | 千里眼私有协议多通道、大华公有云协议设备、海康SDK、ehome、ISUP必传 |
| recordType | int | Y | 录像类型 | 1:普通录像2:告警录像; |
| alarmType | int | N | 告警类型 | 不传则返回所有告警类型(仅查询录像类型为告警录像时生效) |
| urlNetworkType | int | N | 响应url地址网络类型 | 2=公网 |
请求示例
{
"deviceSn": "xx",
"storageType": "xx",
"streamType": 1,
"startTime": "xx",
"endTime": "xx",
"recordType": 1
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| hasMore | int | 设备在当前机房 是否还有录像列表 | 1:是0:否 |
| recordList | List<record> |
record数据模型
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| recordId | String | 录像id | 每次查询只返回一个机房的录像列表,最多返回100条录像 |
| clusterId | String | 所在的集群ID | |
| storageType | String | 存储类型 | 0:云存储 1:设备存储 |
| recordType | int | 录像类型 | 1:普通录像2:告警录像 |
| startTime | String | 录像片段开始时间 | |
| endTime | String | 录像片段结束时间 | |
| alarmType | int | 告警类型 | |
| storagePolicy | int | 存储策略 | 0:标准(默认)1:低频2:归档 |
| url | String | 录像缩略图地址 | |
| expireTime | String | 失效时间,格式为13位毫秒时间戳 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"recordList": [
{
"recordId": "68ee4xxxxx00_0@1053",
"expireTime": "1752828211561",
"recordType": 1,
"storageType": "0",
"startTime": "1752822600000",
"storagePolicy": 0,
"clusterId": "fccxxxxxxxxxab",
"endTime": "1752823800000",
"url": "https://qh.cmqly.com:1443/fileProxy/loadThumbnail?p=bb8582b8adddac1cb71xxx69099f1fec9d5ff2a4738xxxxx3832cae1f2db0be117ff1527f45843371044062e65ecfcb1a31535931853c1feb86xxx03c51c1e0063ae050acee"
}
],
"hasMore": 0
}
}