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": ""
}

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