CATALOG

芯步的开放接口走的是标准HTTP协议,签名校验也比较清晰,实现这类自定义联动其实挺顺手的。下面我从选型到代码落地,把整个方案捋一遍。

写给谁看: 负责公司行政、IT运维的同事,或者准备自己动手改造门禁的“实干派”。目标: 让办公室门禁不再是死板的“刷卡/按按钮”,而是能跟灯光、空调、甚至是企业微信/钉钉玩起来的智能系统。

一、 咱们先聊聊痛点(为啥要折腾?)

传统的办公室门禁,大多就是“刷卡开门”、“密码开门”。说实话,有点浪费资源了。我们就想实现几个小目标:

  1. 人来灯亮,人走断电: 最后一个离开的人关门后,办公室自动关灯、关空调。

  2. 访客自助: 访客来了,前台不用下楼,在手机上发个临时密码或者点一下按钮,门就开了。

  3. 老板专属通道: 老板刷脸(或者按特定指纹),不仅开门,走廊灯自动亮起,空调调到合适温度,甚至音响播报“欢迎光临”。

这些“骚操作”就是标题里说的 “自定义联动操作” 。而实现这一切的关键,就是芯步提供的开放接口

二、 核心逻辑:怎么连?怎么动?

要实现联动,核心就三步:触发 → 逻辑判断 → 执行

  • 触发源(耳朵): 可以是手机App点击、定时任务、WebHook,或者传感器(如门磁、人体红外)。

  • 大脑(逻辑): 我们写的脚本、服务器或者低代码平台(如Node-RED、HomeAssistant)。

  • 执行者(手脚): 芯步的智能硬件(门禁控制器、智能开关等)。

芯步的优势在于,它的接口非常简单,而且支持 HTTPMQTT 两种方式。HTTP适合快速调用,MQTT适合高并发、实时性要求高的联动。

三、 硬件选型推荐(得先买对东西)

根据我们要实现的功能,可以去官网找对应的硬件。参考搜索结果:

  1. 智能密码门禁 (触摸/按键版): 这是核心件。它支持下发动态密码,支持HTTP接口控制,还有12位触摸按键。安装在门口,用于验证身份

  2. 智能墙壁出门开关: 这个太有用了。它其实是一个继电器。我们可以把它串联在电磁锁的电源线上。通过API控制它的通断,就能远程“啪”一下把门打开

  3. 智能墙壁开关 (多路): 装在办公室里面的墙上。联动逻辑触发时,让它去开灯或关灯

  4. 16路通用控制器: 如果你要控制会议室投影幕、升降桌、多路灯光,这个性价比比较高,一台设备控制16个回路

四、 实战操作:手把手实现几种联动

我们要动手写点代码(或者配置脚本)了。下面的示例都是基于 HTTP接口,即任何编程语言都能看懂,甚至Excel都能调。

准备工作:找到你的“身份证”

在调用接口前,登录芯步控制台,拿到这三个东西:

  • AppID: 你的应用ID。

  • AppSecret: 你的应用密钥(要保密)。

  • Device ID: 贴在硬件上的ID(比如门禁是820720)。

这里有个小坑要注意:调用接口必须传签名sign,生成规则是 md5(md5(AppSecret) + ts),目的是防止接口被恶意调用

联动第一种场景:前台远程开门(访客来了不用起身)

场景描述: 访客按门铃,前台在电脑上点一下“开门”按钮,门锁打开5秒,然后自动锁上。

执行逻辑: 前台页面 -> 调用API -> 控制“出门开关”短暂断电。

代码实现(Python示例):(这里稍微口语化解释一下代码逻辑,不做附件形式,直接给核心思路)

参考: 中明确提到了reset命令,用来实现这种“按一下开几秒”的脉冲控制。

联动第二种场景:动态密码(顺丰小哥放快递)

场景描述: 快递员按门铃,你在手机上给他发一个“000111”的密码,有效期5分钟,过期作废。

实现逻辑: 你的后台调用API -> 向“智能密码门禁”下发密码 -> 门禁存储密码 -> 快递员输入。

核心指令(下发密码):我们要针对 智能密码门禁 发指令。假设设备ID是 900001。

这样就不需要给快递员买门禁卡了,省心省力。

联动第三种场景:终极自定义联动(“老板模式”)

场景描述: 老板下班打卡时,门禁系统识别到老板的指纹(或特定卡片),系统不仅开门,还自动关掉全楼的灯光总闸(省电),同时启动布防(报警器)。

这里就需要用到 分组控制批量控制 了。芯步支持 group/control 接口

操作:

  1. 在芯步后台,把办公室所有的“智能开关(控制灯光)”、“智能插座(控制饮水机)”添加到一个叫“Total_Off”的分组里,得到分组ID: 10086。

  2. 老板的开门动作触发后,调用关闭分组指令:

就这么简单,配合老板进门那个动作,一条指令全屋断电。

五、 高级玩法:让门禁学会“自言自语”(MQTT)

如果你想做实时反馈,比如“谁刷了门禁,企业微信群立刻弹消息”,用上面的HTTP轮询比较累,这时候上 MQTT

芯步支持MQTT协议

  • 地址:

  • 端口: 1883

优势:当你密码门禁被人开锁时,设备会主动往MQTT服务器“扔”一条消息。你的服务器订阅这个消息,瞬间就能知道:“哦,张三在9:05进了门。” 然后触发自动化:给张三的媳妇发条短信报平安(开玩笑的),或者只是记录考勤。

六、 注意事项(避坑指南)

  1. 关于reset命令:控制电磁锁时,一般要用 reset=5000。千万别用 power=0

    • 解释: 如果你发了 power=0,门锁断电开门了,但接口不会让它恢复,门就一直开着,这叫做“常开故障”。reset 是专门设计用来做门禁脉冲控制的,一定要分清

  2. 签名(Sign)问题:这个最容易出错。时间戳 ts 必须是 (10位数字),不是毫秒。如果签名错误返回 5006,检查一下是不是这个坑

  3. 局域网控制:如果你公司内网断了,但局域网是通的,芯步设备支持局域网私有化。只要能Ping通设备的IP,在内网里直接POST请求一样生效,外网断了照样能开门。

总结

通过芯步的开放接口,你可以把办公室的门禁从一个“孤独的设备”变成一个“智能生态的开关”。

  • 不想写代码?:直接用芯步自带的控制台也能做简单的定时或联动。

  • 想玩出花?:拿到HTTP接口文档,写几行Python/Node.js/Java代码,搭配企业微信、钉钉或者你自己写的OA系统,门禁就能实现无数组自定义玩法。