获取设备可控制的属性
<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><br/><code>DeviceControl</code>获取设备如复位、重启等不会响应回复的控制参数;<br/><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> {
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;Success&quot;,
&quot;result&quot;: [
{
&quot;optNumber&quot;: &quot;PHASE_LOSS&quot;,
&quot;Identifier&quot;: &quot;PHASE_LOSS&quot;,
&quot;Name&quot;: &quot;缺相限值, 0~265.0&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;V&quot;,
&quot;Value&quot;: &quot;0&quot;,
&quot;DataSpecs&quot;: {
&quot;min&quot;: 0,
&quot;max&quot;: 265,
&quot;dataType&quot;: &quot;DOUBLE&quot;,
&quot;step&quot;: 0.1
}
},
{
&quot;optNumber&quot;: &quot;I_TR&quot;,
&quot;Identifier&quot;: &quot;I_TR&quot;,
&quot;Name&quot;: &quot;电流传输变化率 0~255&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;&quot;,
&quot;Value&quot;: &quot;0&quot;,
&quot;DataSpecs&quot;: {
&quot;min&quot;: 0,
&quot;max&quot;: 255,
&quot;dataType&quot;: &quot;INT&quot;,
&quot;step&quot;: 1
}
},
{
&quot;Identifier&quot;: &quot;Status&quot;,
&quot;Version&quot;: 0,
&quot;Value&quot;: &quot;1&quot;,
&quot;DataType&quot;: &quot;bool&quot;,
&quot;Unit&quot;: &quot;&quot;,
&quot;Name&quot;: &quot;合分状态&quot;,
&quot;DataSpecsList&quot;: [
{
&quot;gmtModified&quot;: 1564541099000,
&quot;custom&quot;: true,
&quot;dataType&quot;: &quot;BOOL&quot;,
&quot;name&quot;: &quot;关&quot;,
&quot;id&quot;: 6321587,
&quot;gmtCreate&quot;: 1564541099000,
&quot;value&quot;: 0
},
{
&quot;gmtModified&quot;: 1564541099000,
&quot;custom&quot;: true,
&quot;dataType&quot;: &quot;BOOL&quot;,
&quot;name&quot;: &quot;开&quot;,
&quot;id&quot;: 6321588,
&quot;gmtCreate&quot;: 1564541099000,
&quot;value&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>