倒序查询设备云录像片段
# getCloudRecords:倒序查询设备云录像片段
# 功能详情
按条件查询所有录像记录(倒序展示)。
# 请求地址
https://openapi.lechange.cn/openapi/getCloudRecords
# 子账户token请求所需最小权限
"Permission":"RecordReplay" "Resource":"cam:序列号:通道号"
# 传入参数说明
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员或者子账户accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| channelId | String | 是 | 通道号 | ||
| beginTime | String | 是 | 开始时间,yyyy-MM-dd HH:mm:ss | ||
| endTime | String | 是 | 结束时间,yyyy-MM-dd HH:mm:ss | ||
| count | Long | 是 | 分页查询的数量,每次最大30条 |
查询策略:按照对起止时间内的云录像片段降序排序,返回前count数的云录像片段信息,下次查询可以将前次的录像片段最小beginTime当做下次endTime入参继续向前查询。
使用举例:遍历查询2021-12-01 10:00:00到2021-12-01 11:00:00时间段的录像片段信息。
步骤1: 设置beginTime=2021-12-01 10:00:00,endTime=2021-12-01 11:00:00,count=30,调用getCloudRecords协议查询,平台返回30条录像片段。
步骤2: 取步骤1返回的录像片段的最小beginTime=2021-12-01 10:30:00, 那么beginTime - 1s后,把2021-12-01 10:29:59作为下次查询的endTime入参,继续调用getCloudRecords协议查询,循环此操作。
步骤3: 当getCloudRecords协议返回的录像片段最小beginTime小于等于查询开始时间或者getCloudRecords协议返回的录像片段数小于count值时,可以认为遍历完成。
# 样例输入
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"74bc756ebd53e9eef2836f8cf1730c10",
"time":1599031074,
"nonce":"8ec8a7bd1d1c95420de20d92422d457d"
},
"params":{
"token":"At_12345678901234567890123456789012",
"deviceId":"TESTQWERXXXX",
"channelId":"0",
"beginTime":"2016-05-19 00:00:00",
"endTime":"2016-05-19 23:59:59",
"count":10
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 返回data字段说明
| 字段名 | 字段类型 | 字段说明 | |
|---|---|---|---|
| records | recordId | String | 录像Id |
| deviceId | String | 设备序列号 | |
| channelId | String | 通道号 | |
| beginTime | String | 开始时间 | |
| endTime | String | 结束时间 | |
| size | String | 云录像的大小(单位byte) | |
| thumbUrl | String | 缩略图Url | |
| encryptMode | Integer | 加密模式(0:默认加密模式;1:用户加密模式) | |
| recordRegionId | String | 录像分区id | |
| type | String | 录像类型:1000事件云录像,2000连续云录像,10001人形检测云录像 | |
# 样例输出
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"result":{
"data":{
"records":[{
"recordId":"1234567890",
"deviceId":"TESTQWERXXXX",
"channelId":"0",
"beginTime":"2016-05-19 00:30:59",
"endTime":"2016-05-19 00:31:36",
"size":"123456",
"thumbUrl":"http://lechangecloud/20160519",
"encryptMode":0,
"recordRegionId":"XXXXXXXXX",
"type":"2000"
}]
},
"code":"0",
"msg":"操作成功"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21