IoT视频云

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

    视频片段查询

    最近更新时间: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="
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close