CATALOG

芯步的智能墙壁出门开关开放了HTTP接口,这意味着只要你的系统能发起网络请求,就能直接控制门禁——不需要中间网关,也无需改造现有硬件。以下方案涵盖签名计算、接口调用、集成架构和安全,可快速落地。

解决方案:基于芯步HTTP接口的会议室门禁控制系统集成

1. 概述

本方案的目标是指导开发者如何利用芯步智能墙壁出门开关(型号:UNI-KG-CM-C)的开放API,将其快速集成到现有的企业OA、会议室预定系统或门禁管理平台中。

通过本方案,可以实现:

  • 联动预定:只有成功预定了该时段的员工才能开门。

  • 远程控制:管理员可在后台远程释放门锁。

  • 无感升级:利用现有Wi-Fi网络,无需额外布设网关。

2. 硬件与接口特性

硬件设备:智能墙壁出门开关

  • 安装方式:标准86型底盒,可直接替换原有门禁按钮,串联在电磁锁电源回路中

  • 网络:支持2.4G Wi-Fi,无需网关,直连路由器

  • 核心机制:本质上是一个继电器控制器。通过断开电路(给电磁锁断电)实现开门,延时后自动闭合电路恢复锁定状态。

开放接口:HTTP API

  • 协议:HTTP/HTTPS,支持公网与局域网(私有化部署)

  • 响应速度:命令下发至执行约80-120ms

3. 集成准备与认证机制

在开始编码前,需在芯步控制台完成以下配置:

  1. 获取凭证:登录芯步工作台,获取 AppIdAppSecret(开发者密码)

  2. 设备配网:将墙壁开关接入办公Wi-Fi,并在控制台记录下唯一的 DeviceId (设备ID)

  3. 签名算法接口安全性基于动态签名验证。签名计算规则如下(以伪代码为例):

    注:Ts 为Unix时间戳(秒),用于防止请求重放。时间戳与签名有效期通常为5分钟

4. 接口调用与门禁逻辑实现

这是集成的核心部分。会议室门禁通常需要“短按开门”效果:即按下按钮(或点击软件开门),门锁吸合3-5秒后自动恢复上锁。

推荐命令:使用 reset 指令。

  • 逻辑:先断开继电器(开锁),等待N毫秒,自动重新闭合继电器(闭锁)。

  • JSON示例

    该命令非常适合门禁场景,防止门锁一直处于打开状态

请求示例(cURL)

5. 系统架构集成方案(软件侧)

为了将其集成到公司现有的会议室系统中,采用以下三层架构:

  1. 前端/客户端层

    • 钉钉/企业微信小程序:在会议室详情页增加“开门”按钮。

    • Web管理后台:为管理员提供远程运维入口。

    • 物理按钮:保留原有的墙壁开关作为备用(机械直连或同样通过API控制)。

  2. 业务逻辑层(你的服务器)

    • 权限校验:调用开门API前,请一定要校验当前用户:

      • 是否有该会议室该时间段的预定权限?

      • 是否是管理员?

    • 日志记录:记录每一次开门请求(谁、什么时间、哪个会议室、结果)。

    • 免打扰逻辑:如果会议未在进行中(如深夜),可禁用API调用,防止误触。

  3. 设备控制层(芯步云/本地)

    • 公网模式:你的服务器通过HTTPS调用芯步官方API。

    • 私有化/局域网模式(推荐高安全场景) :芯步支持私有化部署。如果你的会议室服务器与开关在同一局域网,可直接将请求指向设备的本地IP,不经过外网,降低延迟并提升安全性

6. 进阶功能与故障处理

1. 保持状态逻辑(防占模式)有时候需要开会时保持门常开(如上午9:00-12:00不锁门):

  • 使用 power 命令:{"power":0} (断电开锁),会议结束后发送 {"power":1} (通电闭锁)。

  • 注意:长时间开锁需配合门磁传感器检测门是否关闭,否则电磁锁长时间通电可能发热。

2. 自动巡检与心跳

  • 开关支持Wi-Fi连接,你的后台定期查询设备状态。若设备离线,及时通知IT人员处理,避免“人到门不开”的情况。

3. 代码封装在你的项目中封装一个核心类 YoyoIoTClient

  • 方法1: calcSign(appSecret, ts) -> 生成签名。

  • 方法2: controlDevice(deviceId, command, delay) -> HTTP请求器。

  • 方法3: unlockDoor(deviceId, duration=3) -> 专门针对门禁,自动构建 reset 命令(duration*1000毫秒)。

7. 总结

通过以上方案,开发者可以在1小时内完成从接口调试到业务集成的全过程。利用芯步提供的开放HTTP接口和简单的 reset 延时指令,可以极大地降低会议室门禁智能化改造的复杂度,实现预定即权限、手机一键开门的流畅体验。