IoT视频云 > API 文档 > 视频片段收藏

视频片段收藏

最近更新时间：2019-12-24 16:56:08

描述

该接口用于对指定的视频片段进行收藏，保存在云存储上。

请求

请求语法

POST /v1/apps/<appid>/devices/<encodeDeviceName>/vod/saveas?channelid=<Channelid> HTTP/1.1
Host: linking.qiniuapi.com
Content-Type: application/json
Authorization: <QiniuToken>

{
    "fname": "<saveFileName>",
    "format": "<fileFormat>",
    "start": "<fromTimestamp>",
    "end": "<toTimestamp>", 
    "maxDuration": "<maxDurationSecond>"
}

请求参数

参数名称	必填	字段类型	说明
appid	是	string	设备所属应用的appid，设备名称只能由 4-200 位英文字母和数字组成
encodeDeviceName	是	string	设备名称进行URL安全的Base64编码后得到的字符串
Channelid	否	int	频道id，当设备类型为网关时，需指定频道id进行视频片段的收藏

请求头
该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅公共请求头。
请求元素

参数名称	必填	字段类型	说明
fname	否	string	设置保存文件的名称，不指定的话会默认生成
format	否	string	文件格式，默认和fname的后缀相同，如果两者有冲突则返回错误
start	是	int	开始时间，unix timestamp 以秒为单位
end	是	int	结束时间，unix timestamp 以秒为单位
maxDuration	否	int	保存的回放内容最长时间，默认为600秒，最大为3600秒

响应

响应头
该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。
响应元素

200 {
    "fname": "<fileName>",
    "duration": "<durationSecond>"
}

参数名称	说明
fname	文件名称
duration	保存的回放内容的时间，单位：毫秒

示例

请求示例

POST /v1/apps/test/devices/dGVzdGRldmljZTE=/vod/saveas  HTTP/1.1
Host: linking.qiniuapi.com
Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
Content-Type: application/json

{
    "fname": "test.mp4",
    "format": "mp4", 
    "from": 1537891212,
    "to": 1537891412, 
    "maxDuration": 360
}

响应示例

HTTP/1.1 200 OK
Access-Control-Allow-Origi: *
Connection: keep-alive
Content-Length: xxx
Content-Type: application/json
Date: Wed, 26 Sep 2018 11:42:10 GMT
Server: nginx/1.8.0
Vary: Accept-Encoding
X-Reqid: 6SAAABDWHM1o8FcV
X-Whom: cs1

200 {
    "fname": "test.mp4",
    "duration": 360
}

以上内容是否对您有帮助？