getCloudRecords（倒序查询设备云录像片段）

getCloudRecords：倒序查询设备云录像片段

要点：https://openapi.lechange.cn/openapi/getCloudRecords · 权限 "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	Integer	是		1–100	每页条数（示例可用 30，上限与 queryCloudRecords 一致）
type	String	否			按录像类型过滤（白名单见 `RecordConst.RECORD_TYPE`，如 `1000` 事件、`2000` 连续、`1001` 人头、`1003` 人脸等）
recordId	String	否	`-1`		游标起点录像 ID；首页可省略（等价 `-1`）
nextRecordId	String	否			上一页返回的最后一条 `recordId`，与时间窗翻页二选一
nextRecordRegionId	String	否			与 `nextRecordId` 配套的 `recordRegionId`
filterByChannel	String	否			是否按通道过滤（可选）
productId	String	否			产品 ID（可选）
cloudType	String	否			云录像套餐类型（可选）
multiType	String	否			多类型组合过滤（可选）

查询策略（时间窗翻页）：按起止时间内云录像片段降序，返回前 count 条；下次可将本批最小 beginTime 减 1 秒作为新的 endTime 继续向前。
游标翻页：传入 recordId（默认 -1）及上一批的 nextRecordId / nextRecordRegionId，可不改 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（≤100），调用 getCloudRecords 查询。
步骤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": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time": 1706511734,
        "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
    },
    "params":{
        "token": "<yourAccessToken>", 
        "deviceId":"TESTQWERXXXX", 
        "channelId":"0", 
        "beginTime":"2016-05-19 00:00:00", 
        "endTime":"2016-05-19 23:59:59", 
        "count":10 
    }
}

响应字段

字段名		字段类型	字段说明
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	PaaS 录像类型码：如 `1` 手动、`2` 消息、`1000` 告警事件、`1001` 人头、`1003` 人脸、`2000` 连续云录像、`3000` 转存等（以设备/PaaS 返回为准）

响应示例

{
    "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":"操作成功"
    }
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

设备访问与通道（DV10xx）

错误码	错误码说明	下一步
`DV1007`	设备离线或超时	等设备上线；低电休眠先唤醒
`DV1009`	设备正忙	稍后重试
`DV1012`	分享/授权设备权限不足	核对子账号 `Permission` / `Resource`
`DV1019`	能力集不支持	确认型号与设备能力
`DV1020`	通道离线	检查通道与设备状态
`DV1026`	不支持此功能	换接口或升级固件
`DV1028`	未绑定或通道不存在	核对 `deviceId` / `channelId`
`DV1030`	设备休眠	唤醒后再调
`DV1057`	通道不存在	核对通道号
`DV1061`	设备响应超时	检查设备网络
`DV1062`	需先唤醒设备	调用唤醒接口
`DV1069`	不满足操作条件	见 `msg`

云录像（RC）

错误码	错误码说明	下一步
`RC1001`	云录像不存在	核对时间与 token
`OP1019`	该时间段无录像	换时间范围或确认云存储计划

更多见错误码 · RC。

说明

子账号 token 须具备最小权限：Permission 为 RecordReplay，Resource 为 cam:{deviceId}:{channelId}。配置见权限码。正序分页见 queryCloudRecords。