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

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