IoT视频云 > API 文档 > 视频片段查询

视频片段查询

最近更新时间: 2019-12-20 15:47:08

描述

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

请求

请求语法

GET /v1/device/resource/segments?dtoken=<deviceAccessToken>&start=<startTimestamp>&end=<endTimestamp>&marker=<marker>&limit=<limit>&channelid=<Channelid>&meta={"key":"value"} 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查询视频切片的片段记录
meta	否	string	片段信息中的自定义参数，如视频片段上传时添加了此参数，查询视频片段时可通过此参数过滤查询对应的片段信息示例： `{"type":"1", "type":"2"}` 注：支持通配符，例如：{"type":"*"}，代表查询所有meta信息中key为type的所有片段

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

响应

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

200 {
    "items": [
        {
            "from": "<fromTimestamp>",
            "to": "<totTimestamp>",
            "frame": "<frameURL>",
            "meta": {
                "key1": "value1",
                "key2": "value2"
            }
        },
        {
            "from": "<fromTimestamp>",
            "to": "<totTimestamp>",
            "frame": "<frameURL>",
            "meta": {
                "key1": "value1",
                "key2": "value2"
            }

        }       
        ...
    ],
    "marker": "<marker>"
}

参数名称	说明
from	视频片段的起始时间
to	视频片段的结束时间
frame	视频片段截帧文件
marker	返回的列举位置标记，作为下次列举的起点信息

示例

请求示例

GET /v1/device/resource/segments?dtoken=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:l5hyIN3KWvsq8RUWVoZCfwayLzo=:eyJhcHBpZCI6IjNubTR4MDg3YjMwbzMiLCJkZXZpY2UiOiJhbmppYV90ZXN0X0Z1bGx0aW1lIiwiZGVhZGxpbmUiOjE1NzY4NDQ1MzksInJhbmRvbSI6MTU3NjgyNjUzOTUxNDM3MDgzNiwic3RhdGVtZW50IjpbeyJhY3Rpb24iOiJsaW5raW5nOnZvZCJ9XX0=&start=1576771200&end=1576857600&limit=2  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": 1576771203,
      "to": 1576771208,
      "frame": "http://pdwjeyj6v.bkt.clouddn.com/linking/v1/3nm4x087b30o3-YW5qaWFfdGVzdF9GdWxsdGltZQ==/frame/1576771203582-WAhO5pGPAgvB6H855eyI.jpg?e=1576827020&token=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:tkJttEe39SPv6_4Q01WrgSehBrI",
      "meta": {}
    },
    {
      "from": 1576771208,
      "to": 1576771218,
      "frame": "http://pdwjeyj6v.bkt.clouddn.com/linking/v1/3nm4x087b30o3-YW5qaWFfdGVzdF9GdWxsdGltZQ==/frame/1576771208592-CzGZs60eBWgfZBLmU4lh.jpg?e=1576827020&token=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:z3ILNo0lRZn1TdV1iXYdThYj3aU",
      "meta": {
        "move": "body"
      }
    }
  ],
  "marker": "MDE1NzY3NzEyMTg2MTI="
}

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