CATALOG

芯步的智能门禁产品开放标准HTTP接口,支持任何编程语言调用。以下是基于其“智能墙壁出门开关”和“智能密码门禁”产品的远程开门解决方案,涵盖硬件选型、接口对接逻辑和项目集成要点。

1. 项目概述与选型

在智能办公场景中,将传统的物理出门按钮升级为远程控制功能,是提升管理效率和应急响应能力的关键。本方案基于芯步的智能硬件产品,利用其全开放、标准化的HTTP接口,实现任何有网络权限的终端(如PC管理后台、手机APP、大屏控制面板)对门禁锁的远程一键开门

结合芯步的产品线,推荐采用两套硬件组合方案以满足不同场景需求:

  • 方案一:智能墙壁出门开关(推荐新装/改造)

    • 型号特点:直接替换传统的86型出门按钮,支持百兆市电(100-250V AC)直连,负载能力强

    • 适用场景:办公室玻璃门、消防通道门、需要接入原有强电线路的门禁系统。

    • 控制逻辑:通过控制电路的通断时间来模拟按钮按下,驱动电插锁或磁力锁。

  • 方案二:智能密码门禁(推荐高安全场景)

    • 型号特点:集成了触摸键盘与感应区,除了远程控制,还支持动态密码下发

    • 适用场景:CEO办公室、机房、财务室。

    • 控制逻辑:直接向设备下发开门指令(HTTP命令),设备继电器动作开锁。

两种方案均利用2.4G Wi-Fi连接网络,无需额外网关,极大地降低了部署门槛

2. 核心技术实现:开放接口对接

芯步硬件开放HTTP接口,这意味着无论您的项目后端是用Python、Java、Go还是PHP编写,甚至前端JavaScript,只要支持HTTP请求,均可直接调用接口实现远程控制

2.1 接口签名与鉴权机制

为了防止接口被恶意调用,所有请求均需携带动态签名。签名算法如下

Sign = md5( md5(AppSecret) + ts )
  • AppSecret:在芯步控制台获取的开发者密钥。

  • ts:当前Unix时间戳(秒)。

  • 逻辑简述:将AppSecret进行一次MD5加密,拼接上时间戳ts,再将拼接后的字符串整体进行一次MD5加密。

2.2 核心命令下发逻辑

针对“远程控制出门”的核心需求,只需向指定URL发送POST请求。

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

核心参数

  • device:设备的唯一ID(如:820720)。

  • order:具体动作命令

2.3 关键命令详解

针对开门动作(出门按钮功能),主要通过控制继电器的“通断”或“点动”来实现:

命令类型(order字段)说明适用产品示例值
reset先断后通(点动模式)电路断开(开锁),延时N毫秒后自动复位闭合(上锁)。智能出门开关{"reset":"3000"}(断开3秒后自动闭合)
power直接开关直接控制线路的常开或常闭状态。智能出门开关{"power":"1"}(接通)
pwd远程密码开门直接触发门禁主机的开门逻辑(非输入密码)。智能密码门禁参考设备文档

核心实现逻辑:对于出门按钮场景,最常用的是点动控制。例如,发送 {"reset": 5000},设备将立即断开电路(磁力锁失电->门打开),5秒后电路自动重新接通(磁力锁得电->门吸合)。

3. 分步接入指南(代码级实操)

以下以使用cURLJava为例,演示如何在您的项目中集成远程开门功能。

3.1 Java 集成实现(后端示例)

在您的Spring Boot或微服务项目中,可使用OkHttp或RestTemplate实现。

此代码逻辑演示了如何构造请求体及设备指令,实际使用时需根据官方API文档拼接完整URL

3.2 Shell/cURL 快速测试(运维脚本)

如果您只需要编写一个用于管理后台或自动化脚本的快速测试工具,Shell脚本是最轻量的方式

3.3 关键参数获取

  • AppId / AppSecret:登录芯步官网 -> 进入控制台 -> 开发设置

  • Device ID:设备成功连接Wi-Fi后,会自动显示在物联网控制台的设备列表中

4. 硬件施工与接线要点

软件的调用需要硬件的正确连接才能生效。

4.1 接线注意事项

危险警告:智能墙壁出门开关直接接入强电(220V),接线前请一定要断开总闸切勿直接将电插锁/磁力锁接在出门开关上(锁具通常需要12V直流电)。标准的接法如下:

  1. 强电侧:智能开关接入220V零火线。

  2. 弱电侧:通过智能开关的继电器输出端控制一个12V电源适配器的通断。

  3. 锁具侧:12V电源适配器输出端接电插锁/磁力锁。

  4. 逻辑:智能开关断开 -> 12V适配器断电 -> 锁具失电 -> 门开

4.2 配网流程(关键一步)

设备虽无需网关,但必须接入Wi-Fi。

  • 频段要求:仅支持2.4GHz Wi-Fi,不支持5G

  • 操作路径:登录芯步小程序或PC控制台 -> 物联网控制台 -> 网络配置 -> 添加Wi-Fi名称密码 -> 开启手机热点配网(按照页面提示操作)

5. 高级应用:联动与自动化

一旦接口打通,远程开门按钮就不只是简单的“开关”,而是成为了办公自动化的一环:

  • OA系统集成:将开门按钮嵌入企业内部Web系统。员工离职时,系统自动删除相关门禁权限;访客到访时,前台在系统内点击“远程开门”。

  • 访客自助签到:访客在微信小程序或自助登记机上输入预约码,核验通过后,系统后台自动调用HTTP接口开门。

  • IT运维联动:当服务器高温告警或机房烟雾告警时,自动化脚本可直接调用reset命令强制打开机房门,便于无人值守时的紧急通风和救援。

6. 总结

通过接入芯步的开放接口,原本物理存在的“出门按钮”被赋予了数字化的生命。项目的核心工作量仅集中在签名计算reset命令发送这两个环节。该方案不仅实现了远程控制,还利用其80-120ms的低延迟特性以及局域网私有化部署能力,确保了用户体验与数据安全。