查询通道的云端录像列表（好望云平台）（API名称：getCloudRecords）

功能介绍

该接口用于查询通道的云端录像列表。

接口名称	调用说明
获取Token	调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。
获取设备列表	调用该接口获取设备编号和通道ID。查询通道的云端录像列表时，需要输入设备编号和通道ID。

调用流程

图1 查询通道的云端录像列表流程
点击放大

URL

请求方式	HTTPS地址	服务架构	消息体类型
POST	https://*isdp+域名*/openapi/v1/ivmRemote/getCloudRecords	OpenAPI	application/json

请求头

KEY	VALUE	是否必填	描述
Content-Type	application/json	是	无
Authorization	bearer ${access_token}	是	bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数	类型	是否必填	描述
channelId	String	是	通道ID 获取通道ID API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）
deviceId	String	是	设备编号获取设备编号API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）
endTime	String	是	结束时间，格式如：yyyy-MM-dd HH:mm:ss，北京时间
limit	int	否	单页数量，取值范围[1,1000]，不填写时默认值为10 最小值：1 最大值：1000 缺省值：10
offset	int	否	偏移量，offset为0时表示查询第一页的数据，取值范围[0,2147483646]，不填写时默认为0 最小值：0 最大值：2147483646 缺省值：0
recordType	String	否	录像类型，全量录像：NORMAL_RECORD 动检录像：MOTION_RECORD 不传，则默认两种类型
startTime	String	是	开始时间，格式如：yyyy-MM-dd HH:mm:ss，北京时间

响应参数

参数	类型	描述
total	int	录像列表总数
device_id	String	设备ID
channel_id	String	通道ID
records	Array of Record objects	录像列表信息

records出参：

参数	类型	描述
record_id	String	录像ID
record_name	String	录像名称
record_type	String	录像类型：全量录像：ALL_RECORD 动检录像：MOTION_RECORD
record_size	int	录像文件大小，单位（字节）
start_time	String	录像开始时间
end_time	String	录像结束时间

请求示例

{
    " deviceId ": " D2102412469WLL3000011",
    " channelId ": "1",
    " endTime ": "2021-2-2 15:30:30",
    " startTime ": "2021-2-1 00:30:30"
}

响应示例

{
    "total": 1,
    "device_id": "D2102412469WLL3000011",
    "channel_id": "1",
    "records": [
        {
            "record_id": "1000000",
            "start_time": "2020-2-1 17:31:00",
            "end_time": "2020-2-2 12:50:00",
            "record_name": "录像1",
            "record_size": 1024,
            "record_type": "NORMAL_RECORD",
        }
    ],
}