获取设备属性历史数据
<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-27 17:01:05 星期三</td>
<td>修改</td>
</tr>
<tr>
<td style="text-align: left;">VA 1.0.2</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">2024-06-26 13:17:40 星期三</td>
<td>此接口增加了流控限制</td>
</tr>
</tbody>
</table>
<p><strong>简要描述:</strong> </p>
<ul>
<li>获取设备属性历史数据 </li>
</ul>
<p><strong>注意:</strong></p>
<ul>
<li>此接口有<strong>流控限制</strong>,当前为单客户端ip:<strong>5次/秒</strong></li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>https://www.zsdcloud.cn:8443/openApi/History/propHistory.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;">keyCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备标识码</td>
</tr>
<tr>
<td style="text-align: left;">childDeviceKey</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>子设备识别码</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>版本号,当前版本: V2</td>
</tr>
<tr>
<td style="text-align: left;">identifierList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>需要查询的设备属性集合,可由[获取设备实时数据接口](<a href="https://www.showdoc.com.cn/382341824968230/2217337700681456">https://www.showdoc.com.cn/382341824968230/2217337700681456</a> "获取设备实时数据") 返回的identifier获取。支持单次查多个属性,用英文逗号分割,<strong>一次查询的属性不可超过5个</strong></td>
</tr>
<tr>
<td style="text-align: left;">limit</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>每个属性查询的数据点数,默认20个,<strong>最多不可超过200点</strong></td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>查询起始时间,时间戳 ,默认今日起始时间</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>查询结束时间,时间戳,默认当前时间 ,<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;identifier&quot;: &quot;RSSI&quot;,
&quot;valueList&quot;: [
{
&quot;value&quot;: &quot;-101&quot;,
&quot;timestamp&quot;: &quot;1651077782997&quot;
},
{
&quot;value&quot;: &quot;-100&quot;,
&quot;timestamp&quot;: &quot;1651084984998&quot;
},
{
&quot;value&quot;: &quot;-101&quot;,
&quot;timestamp&quot;: &quot;1651088585997&quot;
},
{
&quot;value&quot;: &quot;-99&quot;,
&quot;timestamp&quot;: &quot;1651092188197&quot;
}
]
}
]
}
</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;">identifier</td>
<td style="text-align: left;">String</td>
<td>属性唯一识别字符</td>
</tr>
<tr>
<td style="text-align: left;">valueList</td>
<td style="text-align: left;">JSONArray</td>
<td>属性值结合</td>
</tr>
<tr>
<td style="text-align: left;">value</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>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>