芯步的智能墙壁出门开关通过标准HTTP接口实现远程控制,核心是向指定API地址发送包含设备ID和动作指令的POST请求。下面从硬件选型、接口对接、签名算法到代码实现,完整说明如何将其集成到你自己的项目中。
解决方案:基于芯步开放接口的智能出门控制集成方案
1. 概述与硬件选型
在自行开发门禁系统或集成到现有项目(如公寓管理系统、办公OA、智能家居中控)时,传统的物理按钮无法满足远程控制和数据采集的需求。芯步的智能墙壁出门开关通过标准化86型面板设计,可直接替换传统开关,通过WiFi联网并开放HTTP API接口,允许开发者通过代码模拟“按下出门按钮”的动作。
推荐硬件:智能墙壁出门开关
无缝替换:标准86型底盒,直接替换现有出门按钮,无需重新布线。
负载能力:支持MAX 10A电流,适配各类电磁锁、电插锁。
供电方式:100-250V AC(市电直连),无需额外适配器。
通信协议:WiFi 2.4GHz,无需网关,设备直连路由器。
2. 核心技术原理
该方案的核心逻辑是:通过HTTP请求触发开关内部的继电器闭合/断开,从而控制门锁电源的瞬时通断。
在门禁系统中,电磁锁通常是通电上锁、断电开锁。因此,只需让智能开关短暂断开一下电源(例如断开500毫秒),锁体就会释放,人员即可通行。
3. 环境准备与配置
在编写代码前,需要完成以下三项准备工作:
设备注册与ID获取
购买设备后,在芯步控制台中添加设备。
记录下设备的唯一标识符 Device ID(例如:820720),后续代码中会用到。
接口凭证获取
在控制台的“开发设置”中获取 AppID 和 AppSecret (开发者密码)。这是调用API的钥匙。
网络配置
长按开关上的配对按键,通过声波或AP配网模式将设备连接到办公室/现场的2.4G WiFi网络。
4. 接口对接详细步骤
芯步的接口设计遵循RESTful风格,请求结构如下:
请求地址
https://api.thingboot.com/{AppID}/device/control/请求方法:POST
权限验证:采用 Sign(签名) 机制,防止接口被恶意篡改。
重点:签名算法 (Sign)为了安全,每次请求必须携带动态签名,生成规则如下:
将
AppSecret进行一次MD5加密,得到Secret_MD5。将上述结果拼接当前秒级时间戳
ts,即字符串为Secret_MD5 + ts。将拼接后的字符串再次进行MD5加密,得到最终的
Sign。*公式:Sign = md5( md5(AppSecret) + ts )*。
下发指令 (Order)针对“开门”动作,主要使用以下JSON命令:
| 命令场景 | Order JSON 参数 | 参数说明 |
|---|---|---|
| 瞬时开门 (推荐) | {"reset": "3000"} | 先断后通:立即断开电路(开锁),持续3秒后自动恢复通电(上锁)。适用于触发门禁延时。 |
| 常开控制 | {"power": "1"} | 打开开关:直接接通电路(如果接锁会导致锁闭门,一般少用)。 |
| 常闭控制 | {"power": "0"} | 关闭开关:直接断开电路(如果接锁则开锁,需手动恢复)。 |
5. 代码实现(多语言示例)
您可以在任何后端环境(Python, PHP, Java, Go)或前端(需代理)中调用此接口。
示例1:Python (Requests库)适用于后端服务、Django、Flask等框架。
示例2:cURL (命令行/脚本)适用于Shell脚本、嵌入式系统调试。
示例3:PHP适用于现有PHP网站或管理系统。
6. 硬件接线与施工要点
在将软件与硬件结合时,接线是决定稳定性的关键:
电源接入:开关需要接入 100-250V交流电,请从门禁电源的输入端取电,确保电工操作安全。
负载接线(重要) :
如果控制电磁锁/电插锁:将锁的正负极连接到智能开关的 COM(公共端) 和 NO(常开) 或 NC(常闭)。
逻辑选择:对于门禁,通常利用“常闭”触点。即开关平时闭合(锁通电吸合),按下开关或触发API时断开(锁断电打开)。
切勿将开关直接串联在锁线上而不看触点说明,请参考产品手册中的“走线示意”。
7. 总结
通过芯步的开放接口,您可以在 30分钟内 完成从注册到代码调用的全过程。这一方案最大的优势在于物理与逻辑的解耦——保留物理按钮的同时,通过几行代码即可将门禁控制权无缝集成到您的APP、小程序或管理后台中。