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":"MEGREZ0000001842",
"channelId":"0",
"beginTime":"2016-05-19 00:00:00",
"endTime":"2016-05-19 23:59:59",
"count":10
}
}
返回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":"2342sdfl-df323-23",
"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":"操作成功"
}
}