IoT视频云

    • 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
}
    以上内容是否对您有帮助？