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

#### 简要描述

获取设备变量历史记录

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

#### 请求方式

POST

#### 调用限制

- 调用此接口每分钟不能超过10次
- [本接口严禁周期频繁调用]()
- 单次查询变量数量不得超过10个
- 单次查询单个变量的历史记录不得超过5000条
- 若要获取变量最新数据，请使用[获取历史记录最新数据](http://cloud.usr.cn/document/822.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/1286.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"|
| dataPoints | 必选  | JSONObject  | Body | 数据点列表 |
| timeSort | 可选  | String  | Body | 时间排序 |
| pageNo | 必选  | Integer  | Body | 分页页号（ 从1开始 ）  |
| pageSize | 必选  | Integer  | Body | 分页大小 |
| start | 必选  | Long  | Body | 开始时间时间戳 (毫秒)|
| end | 必选  | Long  | Body | 结束时间时间戳 (毫秒) |

#### 请求参数(dataPoints)

| 名称  | 必选/可选  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| cusdeviceNo | 必选  | String  | 设备编号 |
| dataPointId | 可选  | String  | 变量id ,与identifier二选一|
|identifier|可选|String|变量标识，与dataPointId二选一|

#### 响应参数

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

**响应数据（data）**

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

**响应数据（list）**

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

**响应数据（list）**

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

#### 返回码说明

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

#### 请求示例

<pre>
POST {url}/history/cusdevice/dataPoint
Content-Type: application/json
	
{
    "start": 1690939460000,
    "end": 1690946660000,
    "timeSort": "desc",
    "pageNo": 1,
    "pageSize": 200,
    "dataPoints": [
        {
            "cusdeviceNo": "0000007086000018",
            "dataPointId": 14651697
        }
    ]
}
</pre>

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

<pre>
Content-Type: application/json
	
{
     "data": {
         "list": [
             {
                 "total": 30,
           	     "cusdeviceNo":"231312312321312312312313"
                 "dataPointId": 4616736,
                 "list": [
                     {
                         "time": 1652252049000,
                         "value": "0",
                     },
                     {
                         "time": 1652251989000,
                         "value": "1",
                     }
                 ],
             }
         ],
         "total": 30,
         "pageNum": 1,
         "pageSize": 200
     },
     "info": "",
     "status": 0
 }
</pre>