新增控制设备
<p><strong>简要描述：</strong> </p>
<ul>
<li>通过此接口创建设备激活码，设备扫描激活码即可接受控制</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://xx.com/open/api/request?access_token={accessToken}</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;">cmd</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>指令类型</td>
</tr>
<tr>
<td style="text-align: left;">channel</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>渠道名称</td>
</tr>
<tr>
<td style="text-align: left;">count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>创建设备数量</td>
</tr>
<tr>
<td style="text-align: left;">appIds</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string[]</td>
<td>设备授权的Open AppId</td>
</tr>
</tbody>
</table>
<p><strong>POST参数示例</strong></p>
<pre><code>{
"cmd": 1,
"channel": "system",
"count":1,
"appIds": ["im", "system", "sync"]
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"errorCode": 0,
"errorMessage": "ok",
"data": [
{
"deviceId": 49,
"deviceCode": "f89b44c4c885c3d08ce391021bef57e7",
"openCodes": {
"im": "39ddbbe036968f1516765fb3bfe921e1",
"system": "e976db80eb208a67330e83abb3558fb0",
"sync": "ebb945b029a7564fee0f2ce0c0cfb134"
}
}
]
}</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;">errorCode</td>
<td style="text-align: left;">int</td>
<td>错误码 0表示成功</td>
</tr>
<tr>
<td style="text-align: left;">errorMessage</td>
<td style="text-align: left;">string</td>
<td>错误信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">DeviceInfo[]</td>
<td>创建的设备列表</td>
</tr>
</tbody>
</table>
<ul>
<li>DeviceInfo 设备信息</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deviceId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">设备ID，每台设备唯一</td>
</tr>
<tr>
<td style="text-align: left;">deviceCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">设备激活码，激活设备扫码用</td>
</tr>
<tr>
<td style="text-align: left;">openCodes</td>
<td style="text-align: left;">dictionary</td>
<td style="text-align: left;">以授权appId为key，openCode为value的字典，以后操控设备都用此值</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>备注：无</p>
<p><strong>备注</strong> </p>
</li>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>