查询历史纪录-API外包专用文档-有人云

#### 简要描述

获取设备数据点历史记录

#### 请求URL

https://{Endpoint}/usrCloud/dev/getDeviceDataPointHistory

#### 请求方式

POST

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| token | 必选  | String  | Header/Body |  登录成功时返回的登录凭证(注意:token有效时间为2小时，两小时内可以重复使用) |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，默认取为"application/json"|
| devDatapoints | 必选  | JSONObject  | Body | 数据点列表 |
| timeSort | 可选  | String  | Body | 时间排序 |
| pageNo | 必选  | Integer  | Body | 分页页号  |
| pageSize | 必选  | Integer  | Body | 分页大小 |
| startDt | 可选  | String  | Body | 开始时间  |
| endDt | 可选  | String  | Body | 结束时间  |
| start | 必选  | Long  | Body | 开始时间时间戳 |
| end | 必选  | Long  | Body | 结束时间时间戳  |

#### 请求参数(devDatapoints)

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo | 必选  | String  | 设备id |
| slaveIndex | 必选  | String  | 从机地址 |
| dataPointId | 必选  | String  | 数据点id |
| itemId | 必选  | Integer  | 序号 |

#### 响应参数

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| 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://{Endpoint}/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>