IoT视频云

  • IoT视频云 > API 文档 > 缩略图查询

    缩略图查询

    最近更新时间: 2019-12-20 15:46:49

    描述

    该接口用于查询指定时间段内视频片段的缩略图。

    请求

    请求语法

    GET /v1/device/resource/frames?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": [
            {
                "frame": "<frameName>",
                "time":  "<timestamp>"
            },
            {
                "frame": "<frameName>",
                "time":  "<timestamp>"
            }
    
        ],
        "marker": "<marker>"
    }
    
    参数 说明
    frame 截图文件名
    time 截图时间点
    marker 本次列举返回的位置标记,作为下次列举的起点信息

    示例

    请求示例

    GET /v1/device/resource/frames?dtoken=853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=:u372aQV0359mzwTVGxn22sRgFYczzxxx&start=1537891212&end=1537893212 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": [
            {
                "frame": "http://pdwjeyj6v.bkt.clouddn.com/linking/v1/3nm4x087b30o3-YW5qaWFfdGVzdF9GdWxsdGltZQ==/frame/1576818500853-deNqu0RSXVWxvNGdIXIv.jpg?e=1576825681&token=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:XmAvbijJd2xN3t3YlDSaJNTza7Q",                     
                "time":   1537891212
            },
            {
                "frame": "http://pdwjeyj6v.bkt.clouddn.com/linking/v1/3nm4x087b30o3-YW5qaWFfdGVzdF9GdWxsdGltZQ==/frame/1576819051781-pz9azAWKDEa1We9smjvx.jpg?e=1576825681&token=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:GJZcv48TkVaPZlIwm7P0M2GkYY8",             
                "time":  1537891812
            }
        ],
        "marker": ""
    }
    
    以上内容是否对您有帮助?