CATALOG

芯步的设备全面开放HTTP接口,这意味着任何能联网的系统都可以直接向门禁设备发送指令。以下方案围绕“触发→鉴权→指令下发→门锁动作”这条链路展开,你可以根据自己的办公管理系统(如企业微信、钉钉、自建OA)灵活对接。

1. 背景与需求

在现代办公环境中,门禁系统的智能化程度直接影响企业运营效率和员工体验。传统的门禁系统(如钥匙、IC卡)存在钥匙/卡片管理繁琐、容易丢失、无远程控制能力、进出记录难以数字化追溯等痛点。

本方案的目标是利用芯步智能硬件的开放HTTP接口,将传统办公室门禁(如电磁锁、电插锁、自动门)无缝接入企业现有的管理系统(如企业微信、钉钉、飞书或自建OA系统)。实现远程审批开门、一键远程控制、扫码/刷脸联动、进出门禁记录自动归档等智能化功能,且完全支持私有化局域网部署,保障数据安全。

2. 方案核心原理

本方案的核心在于“软件定义硬件”。芯步的门禁设备(如智能控制器、出门开关等)内置WiFi模组,直接连接网络。

控制逻辑链路如下:

用户触发(App/Web点击/扫码) -> 业务服务器(鉴权+记录) -> HTTP API 调用 (携带签名+设备ID+命令) -> 芯步设备(接收命令解析) -> 继电器动作 -> 电锁执行(开门)

通过这种机制,任何具备网络通信能力的编程语言(Java、Python、PHP、Go、Node.js等)或开发工具(如微信小程序开发工具)均可实现对门禁的毫秒级控制。

3. 硬件选型推荐

针对办公室门禁控制的实际场景(控制电磁锁、电插锁或自动门的“开门”信号),选择以下两款核心产品:

设备类型推荐型号/版本核心优势与应用
智能控制器智能控制器4路(直流电压版)首选方案。 拥有4路独立继电器输出,可直接控制12V/24V电磁锁的断电与通电。可接入办公室大门、会议室门、独立办公室门等多个点位,性价比比较高
智能密码门禁UNI-MJ-MM-CM一体化方案。 自带触摸密码键盘,支持在断网或不便使用手机时通过密码开门,保留了传统门禁的操作习惯,同时支持远程HTTP控制
智能出门开关智能墙壁出门开关改装方案。 用于替换原有的物理出门开关。当通过系统远程授权后,按下此开关门才会打开;或者直接通过API模拟“按下”动作开门

硬件连接图示(以控制器为例):

graph TD
    A[220V 电源] --> B[智能控制器4路]
    B -- 直流12V输出 --> C[12V 电磁锁/电插锁]
    D[企业内部服务器] -- HTTP/局域网API --> B
    E[路由器 WiFi] -- 无线连接 --> B
    F[出门开关按钮] -- 物理接线 --> B

4. 接口对接与核心代码实现

芯步的设备开放接口遵循标准的 HTTP POST 协议,数据格式为 JSON。所有设备控制接口逻辑统一。

4.1 接口安全机制(签名计算)

为了防止接口被恶意调用,每次请求必须携带动态签名 sign 和时间戳 ts签名算法逻辑为:Sign = md5( md5(AppSecret) + ts )

4.2 核心动作:远程开门

办公室门禁最常用的场景就是“远程开门”。以下示例展示如何通过API控制ID为 820720 的设备,断开继电器(电磁锁断电,门打开)并持续5秒后自动复位锁门

命令解析:使用 “reset”:5000 比单独的 “power”:0 更符合门禁场景。它实现了开门延迟自动回锁功能,防止门一直打开

4.3 不同硬件对应的控制参数

根据你选择的硬件,order 中的参数略有不同,但结构一致:

  • 控制4路控制器第1路开门{ “order”: { “power1”: 0 } } (0为断电开门,1为通电关门)

  • 控制智能密码门禁{ “order”: { “power”: 0 } }

  • 控制智能插座/出门开关{ “order”: { “reset”: 3000 } } (断电3秒后自动恢复)

5. 落地实施步骤

实施一套基于芯步的门禁系统,遵循以下“三步走”流程:

5.1 设备安装与组网

  • 接线:将芯步智能控制器安装在强电井或门头上方。控制器的“常开/常闭”触点串联在电磁锁的12V电源回路中。

  • 配网:设备支持WiFi 2.4GHz。通过手机App或设备热点,将控制器连接至办公室的无线网络。

  • 获取ID:在芯步管理后台或API返回数据中获取该设备的唯一ID(Device ID)。

5.2 服务端对接开发

  • 获取凭证:注册芯步开发者账号,获取 AppIdAppSecret

  • 编写代码:利用上述的API调用逻辑,在企业内部服务器(OA或钉钉机器人后端)编写一个简单的HTTP请求函数。将这个函数绑定到管理后台的“开门”按钮上。

  • 局域网部署:若办公室对网络安全要求比较高,可选择支持私有化部署的固件版本,所有API流量在内网传输

5.3 业务场景集成

  • 企业微信/钉钉集成:在审批单通过后,自动触发API调用实现“审批通过即可开门”。

  • 访客管理:前台在系统录入访客车牌或手机号,访客到达时,前台点击“临时开门”调用API。

  • 日志审计:所有开门记录均可在芯步后台或通过消息推送拉取到本地数据库,形成考勤/出入报表。

6. 总结

  1. 极低开发门槛:无需钻研复杂的SDK或私有协议(如ZigBee需协调器,或大华SDK需特定环境),标准的HTTP接口让任何Web开发者都能在10分钟内完成对接

  2. 极速响应:实测命令下发到设备执行仅需 80-120ms,几乎无延迟,保证通行体验流畅

  3. 高可靠性:支持WiFi直连,无需网关中转,减少了单点故障风险。同时支持定时任务(如“每天晚上10点自动锁门”)和断电保持状态功能

  4. 降本增效:相比购买昂贵的成套智能门禁系统,利用现有的电锁+芯步控制器进行改造,成本可降低50%以上。通过API对接,彻底解决了门禁卡丢失、补办的行政人力消耗。

通过以上方案,您的办公室门禁将不再是孤立的硬件设备,而是成为企业整体数字化生态中的一个可编程、可监控、高响应的智能执行单元。