获取设备变量历史记录-数据-有人云

#### 简要描述

获取设备变量历史记录

#### 请求URL

https://openapi.mp.usr.cn/usrCloud/dev/getDeviceDataPointHistory

#### 请求方式

POST

#### 用户等级
:fa-check-square-o: 基础版 :fa-check-square-o: 企业版 :fa-check-square-o: 旗舰版

#### 调用限制

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

#### 请求参数

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

#### 请求参数(devDatapoints)

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo | 必选  | String  | 设备的SN |
| dataPointId | 必选  | String  | 数据点id |

#### 响应参数

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

**响应数据（data）**

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

**响应数据（list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| itemId  | String  | 序号  |
| total  | Integer  | 变量数量  |
| dataPointId  | Integer  | 变量id  |
| slaveIndex  | String  | 从机序号  |
| deviceNo  | String  | 设备编号  |
| list  | JSONArray  | 时间对应变量值数组  |
| slaveIndex  | String  | 从机序号  |
| total  | Integer  | 变量数量  |

**响应数据（list）**

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

#### 返回码说明

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

#### 请求示例

<pre>
POST https://openapi.mp.usr.cn/usrCloud/dev/getDeviceDataPointHistory
Content-Type: application/json
	
{
    "devDatapoints": [
        {
            "deviceNo": "01400319084000000006",
            "slaveIndex": "1",
            "itemId": "1",
            "dataPointId": 78682
        }
    ],
    "pageNo": 1,
    "start": 1509452562000,
    "end": 1509456852000,
    "pageSize": 1,
    "timeSort": "desc"
}
</pre>

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

<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "total": 0,
        "pageSize": 1,
        "list": [
            {
                "itemId": "1",
                "total": 0,
                "dataPointId": 47806,
                "slaveIndex": "1",
                "deviceNo": "00000096000000000073",
                "list": [
                	{
                    "time":1579069928000 ,
                    "value": 99
                	 }
                ]
            }
        ],
        "pageNum": 1
    },
    "info": "ok",
    "account": "sy200"
}
</pre>