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

查询通道的云端录像列表(好望云平台)(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",
        }
    ],
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档