IoT视频云

  • IoT视频云 > API Reference > 视频播放 >视频片段查询

    视频片段查询

    最近更新时间:2019-07-29 10:02:30

    描述

    该接口用于查询某个时间段内的视频切片的片段记录。

    请求

    请求语法

    GET /v1/device/resource/segments?dtoken=<deviceAccessToken>&start=<startTimestamp>&end=<endTimestamp>&marker=<marker>&limit=<limit>&channelid=<Channelid>  HTTP/1.1
    Host: linking.qiniuapi.com
    

    请求参数

    参数名称 必填 字段类型 说明
    dtoken string dtoken是用于访问Linking服务时的凭证。生成方式请参照设备访问凭证
    start int 开始时间,unix timestamp,以秒为单位
    end int 结束时间,unix timestamp,以秒为单位
    marker string 上一次列举返回的位置标记,作为本次列举的起点信息(默认为"")
    limit int 最大返回多少条数据,最大1000
    Channelid int 频道id,当设备类型为网关时,需指定频道id查询视频切片的片段记录

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

    响应

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

    200 {
        "items": [
            {
                "from": "<fromTimestamp>",
                "to": "<totTimestamp>",
                "frame": "<frameURL>"
            },
            {
                "from": "<fromTimestamp>",
                "to": "<totTimestamp>",
                "frame": "<frameURL>"
    
            }       
            ...
        ],
        "marker": "<marker>"
    }
    
    参数名称 说明
    from 视频片段的起始时间
    to 视频片段的结束时间
    frame 视频片段截帧文件
    marker 返回的列举位置标记,作为下次列举的起点信息

    示例

    请求示例

    GET /v1/device/resource/segments?dtoken=j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=:j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0111111dddd&start=1537891212&end=1537899212  HTTP/1.1
    Host: linking.qiniuapi.com
    

    响应示例

    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 {
        "items": [
           {
                "from":1547723255,
                "to":1547723335,
                "frame":"linking/v1/2akrar8tp7nww-ZGV2aWNlXzN1NHBxMmJ1NWZkaGE=/frame/1547723255521-MTU0NzcyMzI1NTUyMQ.jpg"
            },
            {
                "from":1547725232,
                "to":1547725608,
                "frame":"linking/v1/2akrar8tp7nww-ZGV2aWNlXzN1NHBxMmJ1NWZkaGE=/frame/1547725232721-MTU0NzcyNTIzMjcyMQ.jpg"
            },
        ],
        "marker": ""
    }
    
    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close