新接入请优先使用 设备能力与事件 与 V2 设备 API。本页保留给仍在调用 POST /openapi/queryLocalRecords 的兼容对接。

queryLocalRecords：查询设备本地录像片段

要点：https://openapi.lechange.cn/openapi/queryLocalRecords · 权限 "Permission":"RecordReplay" "Resource":"cam:序列号:通道号" · 见 错误码

查询设备/通道在指定时间段内，指定类型的本地录像片段，并返回指定范围的片段。

请求参数

查询策略：count 模式——按起止时间内片段升序取 count 条，下次可将上次最大 endTime+1 秒作为 beginTime 继续。queryRange 模式——按页码区间返回片段，与 count 二选一入参。

示例：遍历查询2021-12-01 10:00:00到2021-12-01 11:00:00时间段的设备录像片段信息，假设该时间段录像超过50条。
步骤1: 第一次请求，设置beginTime=2021-12-01 10:00:00，endTime=2021-12-01 11:00:00，count=50，调用queryLocalRecords协议查询，平台返回了50条录像片段。
步骤2: 第二次请求，取步骤1返回的录像片段的最大endTime，假设是2021-12-01 10:30:00，把该时间加一秒，2021-12-01 10:30:01作为下次查询的beginTime入参，endTime还是2021-12-01 11:00:00，count=50，继续调用queryLocalRecords协议查询，以此遍历。
步骤3: 当queryLocalRecords协议返回的录像片段最大endTime大于等于2021-12-01 11:00:00或者queryLocalRecords协议返回的录像片段数小于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":"2020-05-19 00:00:00",
        "endTime":"2020-05-19 23:59:59",
        "type":"All",
        "count":100
    }
}

响应字段

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "records":[{
                "recordId":"/mnt/sd/2020-05-19/001/dav/00/00.30.59-00.31.36[M][0@0][0].mp4",
                "fileLength":713883,
                "channelID":"0",
                "beginTime":"2020-05-19 00:30:59",
                "endTime":"2020-05-19 00:31:36",
                "type":"Event",
                "streamType":"main"
            }]
        }
    },
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}

错误码

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

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

子账号（SUB）

更多见 错误码 · SUB。

设备访问与通道（DV10xx）

说明

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

设备与通道须在线；离线时查询可能失败，见 错误码 设备访问段（DV10xx）。type 默认 All；可选 Event、Manual 及细粒度告警类型，与能力 record.file.list 枚举对照。

相关

• 录像查询（HTTP 与 invoke 对照）
• 录像回放：本地录像与云录像
• 调用约定
• 遗留 · 本地录像查询
• 推荐入口