Skip to content

获取指定设备录像文件列表

接口功能

获取指定设备录像文件列表,本接口仅支持:设备接入底座是视联网底座。

请求地址

https://open.qly.cmviot.cn/v3/open/api/device/record/list

请求方式

POST,需要鉴权

请求参数

参数名称参数类型是否必需参数含义说明
deviceSnStringY设备ID
storageTypeStringY存储类型0:云存储 1:设备存储
streamTypeintY码流类型1:主码流,2:辅码流1,3:辅码流2
startTimeLongY查询开始时间13位时间戳,必填
endTimeLongY查询结束时间13位时间戳,必填,需晚于开始时间
pageSizeintN每次查询数量默认100,最大100
sortStringN排序按录像开始时间排序:默认为1;1代表降序,2代表升序
sizeWidthStringN缩略图宽度默认320
sizeHeightStringN缩略图高度默认320
effectiveTimeLongN缩略图地址有效时间单位秒、默认600
channelIdintN通道号千里眼私有协议多通道、大华公有云协议设备、海康SDK、ehome、ISUP必传
recordTypeintY录像类型1:普通录像2:告警录像;
alarmTypeintN告警类型不传则返回所有告警类型(仅查询录像类型为告警录像时生效)
urlNetworkTypeintN响应url地址网络类型2=公网

请求示例

{
	"deviceSn": "xx",
	"storageType": "xx",
    "streamType": 1,
    "startTime": "xx",
    "endTime": "xx",
    "recordType": 1
}

响应参数

参数名称参数类型参数含义说明
hasMoreint设备在当前机房 是否还有录像列表1:是0:否
recordListList<record>

record数据模型

参数名称参数类型参数含义说明
recordIdString录像id每次查询只返回一个机房的录像列表,最多返回100条录像
clusterIdString所在的集群ID
storageTypeString存储类型0:云存储 1:设备存储
recordTypeint录像类型1:普通录像2:告警录像
startTimeString录像片段开始时间
endTimeString录像片段结束时间
alarmTypeint告警类型
storagePolicyint存储策略0:标准(默认)1:低频2:归档
urlString录像缩略图地址
expireTimeString失效时间,格式为13位毫秒时间戳

响应示例

{
    "resultCode": "000000",
    "resultMsg": "成功",
    "data": {
        "recordList": [
            {
                "recordId": "68ee4xxxxx00_0@1053",
                "expireTime": "1752828211561",
                "recordType": 1,
                "storageType": "0",
                "startTime": "1752822600000",
                "storagePolicy": 0,
                "clusterId": "fccxxxxxxxxxab",
                "endTime": "1752823800000",
                "url": "https://qh.cmqly.com:1443/fileProxy/loadThumbnail?p=bb8582b8adddac1cb71xxx69099f1fec9d5ff2a4738xxxxx3832cae1f2db0be117ff1527f45843371044062e65ecfcb1a31535931853c1feb86xxx03c51c1e0063ae050acee"
            }
        ],
        "hasMore": 0
    }
}