注册设备
<p>[TOC]</p>
<blockquote>
<p>注意：目前对外商用版支持中国电信、OneNET平台，如需其他平台，请联系我公司相关人员进行协调</p>
</blockquote>
<h3>请求URL</h3>
<ul>
<li><code>commercial/device</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li><code>POST</code></li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>buttPlatformType</td>
<td>是</td>
<td>Integer</td>
<td>对接平台类型（这里固定为 <code>5</code>）</td>
</tr>
<tr>
<td>gatewayId</td>
<td>是</td>
<td>Long</td>
<td>网关 id</td>
</tr>
<tr>
<td>deviceModel</td>
<td>是</td>
<td>String</td>
<td>设备型号（具体可查询商用版设备型号接口）</td>
</tr>
<tr>
<td>imei</td>
<td>是</td>
<td>String</td>
<td>设备 IMEI 值（固定15位）</td>
</tr>
<tr>
<td>deviceName</td>
<td>是</td>
<td>String</td>
<td>设备名</td>
</tr>
<tr>
<td>deviceAddress</td>
<td>是</td>
<td>String</td>
<td>设备地址</td>
</tr>
</tbody>
</table>
<h3>请求参数示例</h3>
<pre><code>{
"buttPlatformType": 5,
"gatewayId": xxx,
"imei": "149369082257840",
"deviceName": "小李家的锁",
"deviceModel": "UNB-500",
"deviceAddress": "江苏苏州工业园区某某创业园A栋606"
}</code></pre>
<h3>返回参数</h3>
<ul>
<li>Device</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;">id</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">id</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">创建时间</td>
</tr>
<tr>
<td style="text-align: left;">updateTime</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">更新时间</td>
</tr>
<tr>
<td style="text-align: left;">imei</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备 IMEI 值</td>
</tr>
<tr>
<td style="text-align: left;">deviceName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备名</td>
</tr>
<tr>
<td style="text-align: left;">deviceStatus</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">设备状态：<br>0：正常；<br>1：不正常；<br>2：未激活；<br>3：离线</td>
</tr>
<tr>
<td style="text-align: left;">buttPlatformType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">对接平台类型：<br>0：中国电信<br>1：中国移动）</td>
</tr>
<tr>
<td style="text-align: left;">batteryLevel</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">电池电量（0 ~ 100）</td>
</tr>
<tr>
<td style="text-align: left;">signalLevel</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">信号强度（0-5）</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code>{
"code": 0,
"message": "成功",
"data": {
"id": 6668161767047168,
"createTime": "2019-04-24 17:51:32",
"updateTime": "2019-04-24 17:51:32",
"companyId": 6109825533018112,
"productId": null,
"imei": "149369082257840",
"platformDeviceId": "218d3101-979f-4994-a8ed-d3c953aa3c37",
"deviceName": "小李家的锁",
"deviceType": 0,
"deviceStatus": 0,
"buttPlatformType": 0,
"remarks": "对外开放设备",
"userId": null,
"batteryLevel": 100,
"signalLevel": 5,
"lastTimeRefreshTime": null,
"appBatteryLevel": null,
"deviceTypeString": null,
"deviceStatusString": null,
"buttPlatformTypeString": null,
"position": null
}
}</code></pre>