文档首页/ ISDP/ API参考/ API接口/ 智能安监/ 智能摄像头管理/ 查询通道的云端录像列表（好望云平台）（API名称：getCloudRecords）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

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

功能介绍

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

相关API

接口名称

调用说明

获取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",
        }
    ],
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 智能摄像头管理

相关文档