开发者平台

TP-LINK官网首页
开发者平台 / 视频管理系统(VMS)/API功能接口定义/视频数据转mp4

4.6.2 回放视频转mp4上传接口

接口说明:

名称

内容

URL

https://xxx/tums/playback/v1/uploadToServer

功能说明

上传回放视频至ftp服务器。文件格式为mp4。

使用限制

请求参数:

参数名称

参数描述

videoDevId

String

设备索引

storageDevId

String

存储设备索引,可选(不传时默认为其关联的NVR)

videoType

int

录像类型

1代表定时录像,2代表移动侦测录像,3代表全选

startTime

long

回放开始时间

GMT格式

endTime

long

回放结束时间

GMT格式

fileName

String

上传后生成的mp4文件名称(.mp4后缀会自动补齐)。可忽略。

不含该参数时,文件名称为:{设备名称}_{时间戳}.mp4

storageType

String

存储类型。固定传”0”.

downloadInfo

Object

ftpIp

String

ftp服务器的IP地址

ftpPort

Iong

ftp服务器的端口号

username

String

ftp服务器的用户名

password

String

ftp服务器的密码

path

String

视频文件上传至ftp服务器的路径

返回参数:

参数名称

参数描述

error_code

返回码,0 – 成功,其他- 失败,具体请参考返回码章节

taskId

String

上传标识。用于后续获取上传进度或停止上传。

示例:

http://localhost:8888/tums/playback/v1/uploadToServer

request: 
{
    "videoDevId": "2",
    "storageDevId": "2",
    "storageType": "0",
    "videoType": 3,
    "startTime": 1622699529,
    "endTime": 1622701671,
    "fileName": "abc",
    "downloadInfo": {
        "username": "admin",
        "password": "123456",
        "path": "/",
        "ftpIp": "192.168.1.140",
        "ftpPort": 21
    }
}

{
    "result": {
        "taskId": "7de026c366ad401cb7b19bea295cbf64"
    },
    "error_code": 0
}