查询通道的云端录像列表（好望云平台）（API名称：getCloudRecords）
功能介绍
该接口用于查询通道的云端录像列表。
相关API
调用流程
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",
}
],
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
