NB 智能锁接口对接

对外开放api文档


查询设备列表

<p>[TOC]</p> <h3>请求URL</h3> <ul> <li><code>commercial/device/list</code></li> </ul> <h3>请求方式</h3> <ul> <li><code>GET</code></li> </ul> <h3>请求参数</h3> <table> <thead> <tr> <th>参数名</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>imei</td> <td>否</td> <td>String</td> <td>设备 IMEI 值</td> </tr> <tr> <td>deviceName</td> <td>否</td> <td>String</td> <td>设备名</td> </tr> <tr> <td>deviceStatus</td> <td>否</td> <td>Integer</td> <td>设备状态:<br>0:正常;<br>1:不正常;<br>2:未激活;<br>3:离线</td> </tr> <tr> <td>deviceModel</td> <td>否</td> <td>String</td> <td>设备型号</td> </tr> <tr> <td>deviceAddress</td> <td>否</td> <td>String</td> <td>设备地址</td> </tr> <tr> <td>pageNum</td> <td>是</td> <td>Integer</td> <td>第几页,最小为1</td> </tr> <tr> <td>pageSize</td> <td>是</td> <td>Integer</td> <td>每页大小</td> </tr> </tbody> </table> <h3>请求接口示例</h3> <pre><code>https://5gnbiot.com.cn/api/open/commercial/device/list?pageNum=1&amp;pageSize=10</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;">imei</td> <td style="text-align: left;">String</td> <td style="text-align: left;">设备 IMEI 值</td> </tr> <tr> <td style="text-align: left;">imsi</td> <td style="text-align: left;">String</td> <td style="text-align: left;">NB卡号</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;">deviceStatusDesc</td> <td style="text-align: left;">String</td> <td style="text-align: left;">设备状态说明</td> </tr> <tr> <td style="text-align: left;">deviceModel</td> <td style="text-align: left;">String</td> <td style="text-align: left;">设备型号</td> </tr> <tr> <td style="text-align: left;">deviceAddress</td> <td style="text-align: left;">String</td> <td style="text-align: left;">设备地址</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": { "pageSum": 1, "list": [ { "id": xxx, "imei": "359689090666666", "imsi": "460113037666666", "deviceName": "小李家的锁", "deviceStatus": 0, "deviceStatusDesc": "正常", "deviceModel": "NB-700", "batteryLevel": 100, "signalLevel": 5 } ] } }</code></pre>

页面列表

ITEM_HTML