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


获取设备可控制的属性

<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> </tbody> </table> <p><strong>简要描述:</strong> </p> <ul> <li>获取设备可控制的属性接口 </li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>https://www.zsdcloud.cn:8443/openApi/equipment/setInfo.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;">queryType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>查询类型,固定为<code>DeviceControl</code>或<code>GetSetProp</code>&lt;br/&gt;<code>DeviceControl</code>获取设备如复位、重启等不会响应回复的控制参数;&lt;br/&gt;<code>GetSetProp</code>获取设备可下发的属性参数,设置成功后,设备会再次上报对应参数</td> </tr> <tr> <td style="text-align: left;">childDeviceKey</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>子设备标识码。<strong>对于网关-子设备类型,此参数必传</strong>,例如:<code>28</code>智能配电箱获取可下发的属性时必传此参数</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;optNumber&amp;quot;: &amp;quot;PHASE_LOSS&amp;quot;, &amp;quot;Identifier&amp;quot;: &amp;quot;PHASE_LOSS&amp;quot;, &amp;quot;Name&amp;quot;: &amp;quot;缺相限值, 0~265.0&amp;quot;, &amp;quot;DataType&amp;quot;: &amp;quot;double&amp;quot;, &amp;quot;Unit&amp;quot;: &amp;quot;V&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;DataSpecs&amp;quot;: { &amp;quot;min&amp;quot;: 0, &amp;quot;max&amp;quot;: 265, &amp;quot;dataType&amp;quot;: &amp;quot;DOUBLE&amp;quot;, &amp;quot;step&amp;quot;: 0.1 } }, { &amp;quot;optNumber&amp;quot;: &amp;quot;I_TR&amp;quot;, &amp;quot;Identifier&amp;quot;: &amp;quot;I_TR&amp;quot;, &amp;quot;Name&amp;quot;: &amp;quot;电流传输变化率 0~255&amp;quot;, &amp;quot;DataType&amp;quot;: &amp;quot;double&amp;quot;, &amp;quot;Unit&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;DataSpecs&amp;quot;: { &amp;quot;min&amp;quot;: 0, &amp;quot;max&amp;quot;: 255, &amp;quot;dataType&amp;quot;: &amp;quot;INT&amp;quot;, &amp;quot;step&amp;quot;: 1 } }, { &amp;quot;Identifier&amp;quot;: &amp;quot;Status&amp;quot;, &amp;quot;Version&amp;quot;: 0, &amp;quot;Value&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;DataType&amp;quot;: &amp;quot;bool&amp;quot;, &amp;quot;Unit&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;Name&amp;quot;: &amp;quot;合分状态&amp;quot;, &amp;quot;DataSpecsList&amp;quot;: [ { &amp;quot;gmtModified&amp;quot;: 1564541099000, &amp;quot;custom&amp;quot;: true, &amp;quot;dataType&amp;quot;: &amp;quot;BOOL&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;关&amp;quot;, &amp;quot;id&amp;quot;: 6321587, &amp;quot;gmtCreate&amp;quot;: 1564541099000, &amp;quot;value&amp;quot;: 0 }, { &amp;quot;gmtModified&amp;quot;: 1564541099000, &amp;quot;custom&amp;quot;: true, &amp;quot;dataType&amp;quot;: &amp;quot;BOOL&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;开&amp;quot;, &amp;quot;id&amp;quot;: 6321588, &amp;quot;gmtCreate&amp;quot;: 1564541099000, &amp;quot;value&amp;quot;: 1 } ] } } } ] } </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;">IdentifierDis</td> <td style="text-align: left;">String</td> <td>属性所属类别,若多个Identifier的该值相同,代表这几个Identifier同属一个通道或类别,<strong>注此属性不是必返</strong></td> </tr> <tr> <td style="text-align: left;">IdentifierCt</td> <td style="text-align: left;">String</td> <td>属性变比,<strong>此属性不是必返</strong></td> </tr> <tr> <td style="text-align: left;">Identifier</td> <td style="text-align: left;">String</td> <td>属性唯一标识</td> </tr> <tr> <td style="text-align: left;">Name</td> <td style="text-align: left;">String</td> <td>属性显示名称</td> </tr> <tr> <td style="text-align: left;">Value</td> <td style="text-align: left;">String</td> <td>属性当前值 ,<strong>此属性值可能为空字符串</strong></td> </tr> <tr> <td style="text-align: left;">DataType</td> <td style="text-align: left;">String</td> <td>属性类型,<strong>该值可能与DataSpecs和DataSpecsList内的dataType值不一致</strong>,若二者不一致,以DataSpecs和DataSpecsList内的为准</td> </tr> <tr> <td style="text-align: left;">Unit</td> <td style="text-align: left;">String</td> <td>单位,<strong>此属性值可能为空字符串</strong></td> </tr> <tr> <td style="text-align: left;">DataSpecs</td> <td style="text-align: left;">JSON</td> <td>属性限制详细,<strong>不是必返</strong>,其内min代表最小值,max代表最大值,step代表可设置的精确度,例如 0.1代表此属性可设置小数,1为整数,当请求参数为DeviceControl时,返回的isSupport值为1代表支持该控制类型</td> </tr> <tr> <td style="text-align: left;">DataSpecsList</td> <td style="text-align: left;">JSONArray</td> <td>属性限制详细,<strong>注此数组只当DataType为bool或enum时才会返回</strong>,其内value代表可设置的值,name代表值的释义</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML