设备上下线记录-数据-有人云

#### 简要描述

设备上下线记录

<h4>请求 URL</h4><div style="background:rgba(22, 184, 248, 0.1);padding:10px;"><a href="http://cloud.usr.cn/document/685.html">{url}</a>/history/onlineOffline,url获取见http://cloud.usr.cn/document/685.html</div>

#### 请求方式

POST

#### 调用限制

- 调用此接口每分钟不能超过30次
- [本接口严禁周期频繁调用]()
- 单次查询变量数量不得超过10个
- 单次查询单个变量的历史记录不得超过5000条
- 若要获取变量最新数据，请使用[获取历史记录最新数据](http://cloud.usr.cn/document/686.html)
- 如果需要获取实时数据，或想通过数据开发自己个性化业务系统，推荐使用[数据推送](http://cloud.usr.cn/document/627.html "数据推送")或[私有部署](http://cloud.usr.cn/document/7.html "私有部署")

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/658.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| deviceNo | 必选  | String  | Body | 设备的SN |
| timeSort | 可选  | String  | Body | 时间排序 |
| pageNo | 必选  | Integer  | Body | 分页页号（ 从1开始 ） |
| pageSize | 必选  | Integer  | Body | 分页大小 |
| start | 必选  | Long  | Body | 开始时间时间戳 |
| end | 必选  | Long  | Body | 结束时间时间戳  |

#### 响应参数

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| data  | JSONObject  | 响应数据  |
| info  | String  | 提示消息  |
| status  | Integer  | 返回码  |

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| total  | Integer  | 变量总数量  |
| pageSize  | Integer  | 分页大小  |
| list  | JSONArray  | 变量信息数组  |
| pageNum  | Integer  | 分页数量  |

**响应数据（list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo  | String  | 设备编号  |
| total  | Integer  | 变量数量  |
| list  | JSONArray  | 时间对应变量值数组  |

**响应数据（list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| time  | Long  | 时间戳  |
| value  | Integer  | 值  |

#### 返回码说明

| 返回码  | 说明  |
| ------------ | ------------ |
| 0 | 成功  |
| 5016 | 参数为空  |

#### 请求示例

<pre>
POST {url}/history/onlineOffline
Content-Type: application/json
	
{
    "deviceNo": "00000096000000000076",
    "timeSort": "desc",
    "pageNo": 1,
    "pageSize": 10,
    "start": 1579586699000,
    "end": 1582178699000
}
</pre>

#### 响应示例
status: 0，info: ok

<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "list": [
            {
                "deviceNo": "00000096000000000076",
                "time":1579069928000 ,
                "value": 0
            }
        ],
        "total": 1,
        "pageNum": 1,
        "pageSize": 10
    },
    "info": "ok",
    "account": "test"
}
</pre>