芯步的门禁设备用的是HTTP接口,对接起来比那些需要SDK的省事很多——不用编译、不用引库,只要设备有WiFi,任何一个能发HTTP请求的系统(小程序、Web后台、甚至Excel宏)都能直接控制。下面我按“硬件连接 → 接口调用 → 场景联动”的顺序来写,偏口语化一点。
一、 为什么选它?聊聊这个门禁的门道
在搞场景联动之前,咱们得先看看手头的设备——芯步的智能触摸门禁(通常是 UNI-MJ-MM-CM 这个型号)。这玩意儿最讨喜的一点是:它不走网关,直连 WiFi。这意味着你不用多花钱买一个“中枢大脑”,只要现场有 2.4G 的信号,它就能上网。
更重要的是,它不像传统门禁那样只靠刷卡或按键,它全身都是“接口”。我们做的“联动”,说白了就是用代码模拟人手在屏幕上按了一下“开门”。
二、 硬核准备:先让设备“活”在网上
在做复杂的接口对接前,先保证设备在线。
接线:给门禁供上 DC 12V 的电,然后把门锁(电磁锁或电插锁)接在对应的 NO/COM 接口上。记得看一下说明书上的“走线示意”,别把锁直接接在强电上烧了板子。
配网:这是最实在的一步。芯步支持小程序配网。你需要在微信小程序里搜“芯步”,然后用手机开一个 2.4G 的热点(或者输入现场的 WiFi 密码),让门禁去读这个信号。配网成功的标志是设备上的蓝灯常亮(不闪烁)。
获取身份:登录芯步官网的控制台。你需要记下两个关键数据:
{AppId}(你的应用ID)和{Device ID}(刚才配网那个设备的编号,比如 820720)。这俩就是开门的“钥匙”和“锁芯”。
三、 核心干货:怎么通过 HTTP 接口“敲”开门?
这是今天的硬菜。芯步的接口非常 RESTful,说白了就是往一个固定的网址发一段特定的文字(JSON数据)。
1. 接口地址(Endpoint)
你可以把下面这个地址理解为“邮局”,你的指令要发到这里:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
{AppId}:刚才让你记下的那个。{sign}和{ts}:是防盗用的。简单来说就是把你的密钥和时间戳混在一起加密一下。官方文档里有现成的代码段,直接粘过去改成你的参数就行,别自己手写加密,容易出错。
2. 发送指令(Command)
我们要往这个网址“POST”一段 JSON。
第一种场景:最简单的点动开门(最常用)大多数门禁是断电开锁(磁力锁)或通电开锁(电插锁)。为了安全,我们通常用“先断后通”的命令,防止锁一直开着。
解释reset 在这里的意思是:先断开线路(开门),保持 5000 毫秒(5秒),然后自动恢复通电(锁门)。真实场景:比如有人按了门铃,你在手机后台点一下“开门”,门开了 5 秒,客人进来后门自动锁上,不用你操心去关。
第二种场景:纯粹的开关控制如果你不想用定时,想自己决定什么时候关,那就用 power。
3. 代码示例(真的就几行)
不管你是用 PHP 写后台,还是用 JavaScript 写前端(注意跨域和密钥泄露问题),甚至是写 Python 脚本,代码逻辑几乎一样。以最简单的 curl 命令为例:
响应速度:实测通常在 80-120 毫秒 左右,基本上点完按钮还没眨完眼,锁就有动静了。
四、 高阶玩法:这才是真正的“场景联动”
光用手机点一下不叫“联动”,联动是“A发生,B自动执行”。利用芯步的开放接口,我们可以把它挂载到任何自动化系统里。
玩法 1:有人刷脸/刷卡成功 -> 开门
这需要你的门禁系统对接了人脸摄像头或读卡器。
逻辑:第三方人脸识别设备捕获人脸 -> 后端验证通过 -> 后端调用芯步接口 (
order:{"reset": 5000}) -> 门锁打开。效果:员工走到门前,看一眼屏幕,门就开了,手都不用伸。
玩法 2:办公室预定系统联动(共享空间必备)
这适合那种会议室或日租办公室。
逻辑:用户在微信小程序预定会议室 -> 预定时间开始前 5 分钟 -> 系统自动调用接口给门禁下发一个临时密码,并同时执行一次开门。
进阶:预定时间结束 -> 系统调用接口清空该临时密码,防止超时占用。
玩法 3:安防告警联动(异常关门)
逻辑:烟雾探测器报警 -> 物联网平台接收到报警信号 -> 平台自动调用芯步接口
order:{"power": 0}断电开锁。效果:发生火情时,所有门禁自动失效,人员无需刷卡即可逃生。这几乎是硬性指标。
玩法 4:智能家居 / 中控屏对接
如果你家里或者公司有 Home Assistant (HA) 或者其他智能中枢。
逻辑:在 HA 中配置一个 “RESTful Command” 实体。把上面的 HTTP 请求填进去。
效果:你对着 Siri / 小爱同学喊一声“我出门了”,场景联动触发,执行这个 HTTP 命令关门;或者喊“我回来了”,门自动打开。
五、 避坑指南(经验之谈)
关于网络:虽然门禁支持 5 组 WiFi 备份,但在现场安装时,尽量保证信号强度。如果铁门屏蔽严重,拉一根短线出来,或者用 WiFi 中继。设备频繁掉线,接口调用得再快也没用。
关于“reset”的时间
reset的单位是毫秒。比如{"reset": 1000}就是开 1 秒。对于磁力锁,1 秒太短,人还没拉开门又吸上了;对于电插锁,1 秒可能锁舌还没缩回去。实测设置在 3-5 秒(3000-5000 毫秒)比较合适。关于安全:接口调用虽然简单,但千万别把
sign生成的算法暴露在前端代码(如 H5 或 小程序端)里,否则别人抓包就能随意开你的门。记得把接口调用放在你自己的后端服务器上,前端只触发后端接口。
六、 总结
芯步这个触摸门禁的开放接口,做得确实“傻瓜式”。不需要研究复杂的 SDK 和底层协议,就是个 HTTP 请求。只要你的业务系统能跑通网络,不管是打印一张二维码扫码开门,还是对接酒店 PMS 系统实现“一键入住”自动授权,都能通过这简单的几行代码实现。这大概是物联网时代,打通“软硬结合”最经济实惠的一条路了。