IoT视频云

  • IoT视频云 > API 文档 > 设备在线记录查询

    设备在线记录查询

    最近更新时间: 2019-03-25 17:54:13

    描述

    该接口用于查询指定时间段内设备的在线记录。

    请求

    请求语法

    GET  /v1/apps/<appid>/devices/<encodeDeviceName>/historyactivity?start=<startTimestamp>&end=<endTimestamp>&marker=<marker>&limit=<limit>  HTTP/1.1
    Host: linking.qiniuapi.com
    Authorization: <QiniuToken>
    

    请求参数

    参数名称 必填 字段类型 说明
    appid string 设备所属应用的appid,设备名称只能由 4-200 位英文字母和数字组成
    encodeDeviceName string 设备名称进行URL安全的Base64编码后得到的字符串
    start int 开始时间,unix timestamp,以秒为单位
    end int 结束时间,unix timestamp,以秒为单位
    marker string 上一次列举返回的位置标记,作为本次列举的起点信息(默认为"")
    limit int 最大返回多少条数据,最大1000条

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

    响应

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

    200 {
        "items": [
            {
                "loginAt": "<loginTimestamp>",
                "logoutAt": "<logoutTimestamp>"
            },
            {
                "loginAt": "<loginTimestamp>",
                "logoutAt": "<logoutTimestamp>"
            }       
            ...
        ],
        "marker": "<marker>"
    }
    
    参数名称 说明
    loginAt 上线时间点
    logoutAt 下线时间点
    marker 返回的列举位置标记,作为下次列举的起点信息

    示例

    请求示例

    GET /v1/apps/test/devices/dGVzdGRldmljZTE=/historyactivity?start=1537891200&end=1537893200 HTTP/1.1
    Host: linking.qiniuapi.com
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
    Content-Type: application/x-www-form-urlencoded
    

    响应示例

    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": [
            {
                "loginAt": 1537891212,
                "logoutAt": 1537891250
            },
            {
                "loginAt": 1537892200,
                "logoutAt":1537892300 
            }       
    
        ],
        "marker": "ZGV2aWNlXzJha3JhcjlkaGV0c2Q%3D"
    }
    
    以上内容是否对您有帮助?