queryCloudRecords：正序查询设备云录像片段

功能详情

查询设备/通道在指定时间段内的云录像片段，并返回指定范围的片段(正序展示)。

请求地址

https://openapi.lechange.cn/openapi/queryCloudRecords

子账户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
queryRange	String	是			查询范围1-N，N值最大取100，每次最大查询100条录像片段

查询策略：按照对起止时间内的云录像片段升序排序，返回前queryRange（N值）数的云录像片段信息，下次查询可以将前次的录像片段最大endTime当做下次的beginTime入参继续向后查询。

使用举例：遍历查询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，queryRange=1-100，调用queryCloudRecords协议查询，平台返回100条录像片段。

步骤2: 取步骤1返回的录像片段的最大endTime=2021-12-01 10:30:00作为下次查询的beginTime入参，继续调用queryCloudRecords协议查询，循环此操作。

步骤3: 当queryCloudRecords协议返回的录像片段最大endTime大于等于查询结束时间或者queryCloudRecords协议返回的录像片段数小于queryRange（N值）时，可以认为遍历完成。

样例输入

{
    "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":"2020-05-19 00:00:00", 
        "endTime":"2020-05-19 23:59:59", 
        "queryRange":"1-100" 
    }
}

返回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

样例输出

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "result":{
        "data":{
	        "records":[
            {
                "recordId":"1234567890", 
                "deviceId":"TESTQWERXXXX", 
                "channelId":"0", 
                "beginTime":"2020-05-19 00:30:59", 
                "endTime":"2020-05-19 00:31:36", 
                "size":"123456", 
                "thumbUrl":"http://lechangecloud/20160519", 
                "encryptMode":0, 
                "recordRegionId":"xxxxxxxxx" 
            }]
        },
        "code":"0",
        "msg":"操作成功"
    }
}