文档中心 > 云录像下载
云录像下载

最近更新时间:2022-06-15

1、功能介绍

云录像文件下载。下载的时间跨度R = [StartTime, EndTime],最大值1天。

2、请求参数

参数

是否必选

参数类型

描述

ActionString系统指定参数。取值:DownloadCloudRecord
DeviceIdString设备ID
RecordTypeString录像类型。取值:取值,manu(手动录像),time(定时录像),alarm(告警录像)
StorageTypeString

存储类型。取值:device(设备端录像)、cloud(云存储) ; 默认cloud

存储类型为device时下载时长无限制

StartTimeString开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
EndTimeString结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
FileTypeString

下载文件类型,取值:ts、mp4,默认ts

存储类型为device时,仅支持 flv

PrivateFlagInteger是否内网地址。取值:0(否),1(是)。默认值为0
TlsFlagInteger是否使用TLS URL。取值:0:不使用,1:使用。默认1,PrivateFlag为1无效

3、响应参数

参数

是否必选

参数类型

描述

RequestId

String

该条接口请求ID

CodeString错误码 0:表示成功
MessageString提示信息
Dataobject返回数据
├─ RecordUrlString

录像文件下载URL


4、请求示例

请求示例:

GET https://api.unicloud.com/univms?

Action=DownloadCloudRecord

&RecordType=time

&StartTime=2021-02-10T11:12:08Z

&EndTime=2021-02-10T22:12:08Z

&FileType=ts

&公共请求参数

返回示例:

{
    "RequestId": "2bc182b5-20ec-440f-8160-5e43dc26c3eb",
    "Code": "0",
    "Data": {
        "RecordUrl": "https://c22g1005.gw.univms.unicloudcdn.com.cn:10443/10001/files/2c48c26baf6641d793db324def578c29_1626058140_1626230940_all.ts?device_id=2c48c26baf6641d793db324def578c29&start_time=1626058140&end_time=1626230940&record_type=all"
    }
}

5、状态码

状态码

描述

200

OK

400

Bad Request