设备在线记录查询
描述
该接口用于查询指定时间段内设备的在线记录。
请求
请求语法
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"
}
文档反馈
(如有产品使用问题,请 提交工单)