获取设备状态历史数据
<p><strong>日志：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">版本号</th>
<th style="text-align: left;">撰写人</th>
<th style="text-align: left;">时间</th>
<th>修改内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">VA 1.0.0</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">2019-06-08 20:32:56 星期六</td>
<td>创建</td>
</tr>
<tr>
<td style="text-align: left;">VA 1.0.1</td>
<td style="text-align: left;">张才进</td>
<td style="text-align: left;">2022-04-28 12:10:56 星期四</td>
<td>修改</td>
</tr>
<tr>
<td style="text-align: left;">VA 1.1.0</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">2023-05-31 17:39:06 星期三</td>
<td>增加返回更多的数据，例如异常类型、安装位置</td>
</tr>
</tbody>
</table>
<p><strong>简要描述：</strong> </p>
<ul>
<li>获取设备状态历史数据 </li>
</ul>
<p><strong>注意：</strong> </p>
<ul>
<li>因为涉及到时序数据检索，此接口暂不返回总条数和当前页码数。可认为当<strong>某次检索返回的数据条数 < pageSize</strong> 时，下一页将不再有符合检索条件的数据了</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://www.zsdcloud.cn:8443/openApi/History/statusHistory.action</code> </li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>版本，暂固定为<code>V2</code>，注意是大写的字母V</td>
</tr>
<tr>
<td style="text-align: left;">pageNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>页号，默认1</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>页记录数 ，默认5，不可超过50</td>
</tr>
<tr>
<td style="text-align: left;">keyCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>设备标识码，传此参数代表查询标识码为该值的设备状态变化</td>
</tr>
<tr>
<td style="text-align: left;">equipmentTypeId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>设备类型id，传此参数代表查询权限下此设备类型的设备状态变化</td>
</tr>
<tr>
<td style="text-align: left;">projectId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">long</td>
<td>项目id，传此参数代表查询权限下此项目的设备状态变化</td>
</tr>
<tr>
<td style="text-align: left;">statusType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>设备状态集合，0正常，1故障，2报警，3离线。默认查询所有设备状态，若想单独查询某几种状态，多个状态间用英文逗号分隔。eg：<code>1,2</code></td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">long</td>
<td>查询起始时间，13位毫秒级时间戳，<strong>不传默认当天起始时间</strong></td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">long</td>
<td>查询结束时间，13位毫秒级时间戳， <strong>不传默认当前时间</strong>，注意：<strong>单次检索的时间范围不可超过一周</strong></td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;Success&quot;,
&quot;result&quot;: [
{
&quot;exceptionType&quot;: 24,
&quot;exceptionDesc&quot;: &quot;打火报警&quot;,
&quot;equipmentTypeName&quot;: &quot;智能配电箱&quot;,
&quot;installAdd&quot;: &quot;实验室测试26&quot;,
&quot;deviceStatus&quot;: 2,
&quot;keyCode&quot;: &quot;20ABC9-gw-026&quot;,
&quot;projectName&quot;: &quot;研发测试&quot;,
&quot;projectId&quot;: &quot;5449586580&quot;,
&quot;timestamp&quot;: 1685462433419
},
{
&quot;exceptionType&quot;: 23,
&quot;exceptionDesc&quot;: &quot;其他报警&quot;,
&quot;equipmentTypeName&quot;: &quot;智慧安全用电监测装置&quot;,
&quot;installAdd&quot;: &quot;宿舍楼一楼左（下）&quot;,
&quot;deviceStatus&quot;: 2,
&quot;keyCode&quot;: &quot;8610500X094S253&quot;,
&quot;projectName&quot;: &quot;高塘岭&quot;,
&quot;projectId&quot;: &quot;3031224262&quot;,
&quot;timestamp&quot;: 1685462455257
},
{
&quot;exceptionType&quot;: 4,
&quot;exceptionDesc&quot;: &quot;漏电报警&quot;,
&quot;equipmentTypeName&quot;: &quot;智慧安全用电监测装置&quot;,
&quot;installAdd&quot;: &quot;宿舍楼一楼左（下）&quot;,
&quot;deviceStatus&quot;: 2,
&quot;keyCode&quot;: &quot;8610500X094S253&quot;,
&quot;projectName&quot;: &quot;高塘岭&quot;,
&quot;projectId&quot;: &quot;3031224262&quot;,
&quot;timestamp&quot;: 1685462458491
},
{
&quot;exceptionType&quot;: 23,
&quot;exceptionDesc&quot;: &quot;其他报警&quot;,
&quot;equipmentTypeName&quot;: &quot;智慧安全用电监测装置&quot;,
&quot;installAdd&quot;: &quot;宿舍楼一楼左（下）&quot;,
&quot;deviceStatus&quot;: 2,
&quot;keyCode&quot;: &quot;8610500X094S253&quot;,
&quot;projectName&quot;: &quot;高塘岭&quot;,
&quot;projectId&quot;: &quot;3031224262&quot;,
&quot;timestamp&quot;: 1685462470616
}
]
}
</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">keyCode</td>
<td style="text-align: left;">String</td>
<td>设备标识码</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">String</td>
<td>设备上报状态的时间，毫秒级时间戳</td>
</tr>
<tr>
<td style="text-align: left;">deviceStatus</td>
<td style="text-align: left;">int</td>
<td>设备状态，0正常，1故障，2报警，3离线</td>
</tr>
<tr>
<td style="text-align: left;">installAdd</td>
<td style="text-align: left;">String</td>
<td>设备安装位置</td>
</tr>
<tr>
<td style="text-align: left;">projectId</td>
<td style="text-align: left;">String</td>
<td>项目id</td>
</tr>
<tr>
<td style="text-align: left;">projectName</td>
<td style="text-align: left;">String</td>
<td>项目名称</td>
</tr>
<tr>
<td style="text-align: left;">equipmentTypeName</td>
<td style="text-align: left;">String</td>
<td>设备类型名称</td>
</tr>
<tr>
<td style="text-align: left;">exceptionType</td>
<td style="text-align: left;">int</td>
<td>异常类型，<strong>只有当deviceStatus为报警时会返回</strong></td>
</tr>
<tr>
<td style="text-align: left;">exceptionDesc</td>
<td style="text-align: left;">String</td>
<td>异常类型描述，<strong>只有当deviceStatus为报警时会返回</strong></td>
</tr>
<tr>
<td style="text-align: left;">exceptionDetail</td>
<td style="text-align: left;">String</td>
<td>异常明细，<strong>只有当deviceStatus为故障/报警时会返回</strong></td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>