缩略图查询
描述
该接口用于查询指定时间段内视频片段的缩略图。
请求
请求语法
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": ""
}
文档反馈
(如有产品使用问题,请 提交工单)