NB 智能锁接口对接

对外开放api文档


新增指纹、密码、卡、人脸

<p>[TOC]</p> <h3>接口说明</h3> <ul> <li>管理员密码只能下发一个,再次下发,视为更新操作,即先删除之前的密码,再新增新的密码</li> <li>如果是数字密码,password 可以传6位数字密码,或者不填写,服务器会随机生成6位数字密码,并返回</li> <li>指纹、卡、密码最大下发数量各为100个,传参为 password</li> <li>如果是永久密码,可以不传开始时间和截止时间</li> <li>指纹和卡数据,需要专用的指纹读取器和卡读取器获得数据,具体指纹读取器或卡读取器获得,请联系商务对接人员</li> </ul> <h3>请求URL</h3> <ul> <li><code>commercial/device/password</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>imei</td> <td>是</td> <td>String</td> <td>imei</td> </tr> <tr> <td>passwordName</td> <td>否</td> <td>String</td> <td>密码名</td> </tr> <tr> <td>passwordType</td> <td>是</td> <td>Integer</td> <td>密码类型(&lt;br&gt;1:指纹:&lt;br&gt;2:密码;&lt;br&gt;3:卡;&lt;br&gt;11:人脸&lt;br&gt;)</td> </tr> <tr> <td>permanentFlag</td> <td>是</td> <td>Integer</td> <td>永久标记(1:永久密码;2:临时密码)</td> </tr> <tr> <td>passwordAuth</td> <td>是</td> <td>Integer</td> <td>密码权限(1:管理员 2:普通用户)</td> </tr> <tr> <td>password</td> <td>否</td> <td>String</td> <td>密码(具体的指纹数据或卡数据或数字密码)</td> </tr> <tr> <td>icCardModel</td> <td>否</td> <td>Integer</td> <td>IC卡类型(1:身份证;2:普通IC卡;)</td> </tr> <tr> <td>faceImage</td> <td>否</td> <td>String</td> <td>人脸URL(示列:<a href="https://prod-read.oss-cn-shanghai.aliyuncs.com/img/2023-03-13/1678673703525.jpg">https://prod-read.oss-cn-shanghai.aliyuncs.com/img/2023-03-13/1678673703525.jpg</a> ,注意:如果password 参数不为空,则以password 参数为准)</td> </tr> <tr> <td>startTime</td> <td>是</td> <td>String</td> <td>开始时间Date格式,例如:(2024-04-19 23:01:10)</td> </tr> <tr> <td>endTime</td> <td>是</td> <td>String</td> <td>截止时间Date,例如:(2024-04-19 23:01:10);截至时间需大于当前时间</td> </tr> </tbody> </table> <h3>指纹下发数据内容示例</h3> <pre><code>uUJBTRP0o5kpSbepp59ko5/5QbRToZjUoIMGRavUubc0oQi2UEshIQc1owQDXVcv0Pg1oJuBRLdVpegNro0nRKmpvasUno6BUKmpp3QdnjeZUKuuKVZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=,uUJOShP0o5nJSbRpp59ko5/5QbQTIZjUoIA5QYsVO7c0oQiGUEthUqsUro+RUKmppnAdrjSZUKuhqQc1owRjXVdv0Pg1oJuQRLdSIuwFrorXRKmpv1ZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWVlZWAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=</code></pre> <h3>返回参数</h3> <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;">passwordName</td> <td style="text-align: left;">String</td> <td style="text-align: left;">密码名字</td> </tr> <tr> <td style="text-align: left;">passwordType</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">密码类型:&lt;br&gt;1:指纹;&lt;br&gt;2:密码;&lt;br&gt;3:卡</td> </tr> <tr> <td style="text-align: left;">passwordTypeDesc</td> <td style="text-align: left;">String</td> <td style="text-align: left;">密码类型说明</td> </tr> <tr> <td style="text-align: left;">passwordAuth</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">密码权限:&lt;br&gt;1:管理员 &lt;br&gt;2:普通用户</td> </tr> <tr> <td style="text-align: left;">passwordAuthDesc</td> <td style="text-align: left;">String</td> <td style="text-align: left;">密码权限说明</td> </tr> <tr> <td style="text-align: left;">permanentFlag</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">永久标记(1:永久密码;2:临时密码)</td> </tr> <tr> <td style="text-align: left;">permanentFlagDesc</td> <td style="text-align: left;">String</td> <td style="text-align: left;">永久标记说明</td> </tr> <tr> <td style="text-align: left;">password</td> <td style="text-align: left;">String</td> <td style="text-align: left;">密码</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">开始时间(格式为yyyy-MM-dd HH:mm:ss)</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">截止时间(格式为yyyy-MM-dd HH:mm:ss)</td> </tr> <tr> <td style="text-align: left;">realUnlockTimes</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">实际解锁次数</td> </tr> <tr> <td style="text-align: left;">icCardModel</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">IC卡类型(1:身份证;2:普通IC卡)</td> </tr> <tr> <td style="text-align: left;">icCardModelDesc</td> <td style="text-align: left;">IC卡类型说明</td> </tr> <tr> <td style="text-align: left;">phoneNumber</td> <td style="text-align: left;">String</td> <td style="text-align: left;">接收人手机号</td> </tr> </tbody> </table> <h3>返回示例</h3> <ul> <li>暂无,可自行测试</li> </ul>

页面列表

ITEM_HTML