物联网平台外部访问数据定义


获取设备属性历史数据

<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> &quot;获取设备实时数据&quot;) 返回的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>{ &amp;quot;statusCode&amp;quot;: 200, &amp;quot;message&amp;quot;: &amp;quot;Success&amp;quot;, &amp;quot;result&amp;quot;: [ { &amp;quot;identifier&amp;quot;: &amp;quot;RSSI&amp;quot;, &amp;quot;valueList&amp;quot;: [ { &amp;quot;value&amp;quot;: &amp;quot;-101&amp;quot;, &amp;quot;timestamp&amp;quot;: &amp;quot;1651077782997&amp;quot; }, { &amp;quot;value&amp;quot;: &amp;quot;-100&amp;quot;, &amp;quot;timestamp&amp;quot;: &amp;quot;1651084984998&amp;quot; }, { &amp;quot;value&amp;quot;: &amp;quot;-101&amp;quot;, &amp;quot;timestamp&amp;quot;: &amp;quot;1651088585997&amp;quot; }, { &amp;quot;value&amp;quot;: &amp;quot;-99&amp;quot;, &amp;quot;timestamp&amp;quot;: &amp;quot;1651092188197&amp;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>

页面列表

ITEM_HTML