CATALOG

一、概述

共享联合办公空间（如众创空间、孵化器、灵活办公区）的门禁和设备管理直接影响空间运营效率和用户体验。传统方案中，会议室门禁与办公区照明各自独立，无法实现联动控制和管理员远程调度。芯步智能触摸墙壁复合出门开关（型号：UNI-KG-CK）通过开放HTTP接口，可无缝集成到您的空间管理系统中，实现门禁远程控制、场景联动、能耗管理等功能。

核心能力

  • 复合功能设计：集出门开关与控制于一体，适配电磁锁、电插锁等各类电子锁

  • 开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接

  • 远程门禁控制：支持先通后断（脉冲开门）模式，实现远程一键开门

  • 私有化部署：支持局域网运行，数据安全可控

  • 无网关设计：WiFi直连，可设定5组WiFi自动切换

共享办公空间典型应用场景

场景控制对象联动逻辑
会议室预约开门门禁电磁锁用户扫码/刷卡后自动开门
无人时段节能办公区照明检测到无人后自动关灯关空调
管理员远程开门门禁+照明管理员后台一键开门
下班一键关电全部设备统一关闭所有区域电源

二、核心产品选型

2.1 智能触摸墙壁复合出门开关

芯步提供两种出门开关产品。其中，智能触摸墙壁复合出门开关是共享办公空间门禁控制的理想选择：

特性智能触摸墙壁复合出门开关智能墙壁出门开关
产品型号UNI-KG-CK-
操控方式触摸面板按键
外壳材质防火V0级PC防火V0级PC
产品尺寸86×86×41mm86×86×41mm
工作电压100-250V AC（交流市电）100-250V AC
负载功率MAX 1000W/路MAX 1000W/路
待机功耗0.4（全断）- 1.3（全通）W0.4 - 1W
无线连接WiFi 2.4GHzWiFi 2.4GHz
控制接口HTTP APIHTTP API
私有化部署支持支持

数据来源：

2.2 产品核心优势

芯步智能触摸墙壁复合出门开关开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台。

设备核心优势

  • 私有化部署：支持自建消息服务器，可运行在纯局域网环境

  • 无网关设计：设备使用WiFi 2.4G无线网络，采用WiFi直接方式，无需网关支持

  • 多网络备份：可设定5组WiFi网络，优先连接信号最强的进行连接

  • 复合功能：集出门开关与控制于一体，适配各类电子锁

2.3 ⚠️ 重要选型提示

注意区分两款出门开关产品

  • 智能墙壁出门开关：标准出门开关功能，支持HTTP接口控制

  • 智能触摸墙壁复合出门开关：功能更全面，是共享办公空间门禁应用的理想选择

配套电子锁说明：本产品支持所有类型的电磁锁、电插锁。因电子锁品类繁多，芯步未生产，请根据使用场景到第三方购买合适的锁。

接线提醒：切记，请勿直接将电插锁接在出门开关上！具体接线方案请参考产品手册。

三、整体架构

3.1 系统架构图

┌────────────────────────────────────────────────

3.2 共享办公空间联动场景

场景触发方式联动设备实现的方式是
会议室预约开门用户扫码/小程序电磁锁预约验证→API开门
无人自动关灯人体传感器照明/空调状态上报→API关断
管理员远程开门管理后台电磁锁后台操作→API开门
下班一键关电定时任务全区域设备平台定时任务

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

text

参数说明

参数说明示例
{AppId}应用ID（控制台获取）qtyVWcgeMq
{ts}当前Unix时间戳（秒）1747212640
{sign}签名c484eb97...

签名计算公式

sign = md

  • 将开发者密码（AppSecret）进行一次MD5

  • 将这个结果拼接上时间戳ts

  • 对整个拼接后的字符串再做一次MD5

签名计算示例

签名计算方法来源：

4.2 核心命令详解

4.2.1 先通后断（一键开门模式）——核心功能

电磁锁/电插锁的开门方式是先通后断：接通电磁锁电源（开门），等待指定时间后自动断电（锁门）。这是共享办公空间门禁控制的核心命令：

json

效果：接通电源，等待3000毫秒后自动断开

开门时长选项

时长命令适用场景
1秒{"point":"1000"}快速通行门
3秒{"point":"3000"}标准会议室门（推荐）
5秒{"point":"5000"}无障碍通道

4.2.2 先断后通（设备复位）

适用于门禁设备异常时的远程复位：

json

4.2.3 线路通断控制

适用于控制普通电器（照明、排风扇等）：

json
json

命令来源：

4.2.4 状态保持（锁定模式）

适用于需要锁定门禁或设备状态的场景：

json

命令说明来源：

4.3 多语言代码示例

Python

python

JavaScript/Node.js

javascript

Shell（curl）- 快速测试

bash

代码参考：

五、共享办公场景实战

5.1 第一种场景：会议室预约自动开门

需求：用户通过小程序预约会议室，预约生效时段内可通过手机一键开门。

设备配置：每间会议室1台复合出门开关 + 电磁锁

python

5.2 第二种场景：管理员远程调度开门

需求：保洁人员或管理员需要进入会议室打扫时，管理员在后台远程开门。

实现的方式是：管理后台调用HTTP API

5.3 第三种场景：无人时段自动节能

需求：办公区无人时自动关闭照明和空调，降低能耗。

设备配置：人体存在传感器 + 复合出门开关（控制照明）

python

5.4 场景四：下班一键闭店

需求：运营人员在后台一键关闭所有区域的设备电源。

实现的方式是：批量控制多台设备

python

5.5 场景五：会议室使用中锁定门禁

需求：会议进行期间，防止外部人员误入，门禁保持锁定状态。

实现的方式是：使用状态保持命令

python

六、私有化部署方案

共享办公空间对数据安全和系统稳定性要求较高，芯步智能触摸墙壁复合出门开关支持纯局域网运行。

部署模式对比

特性公有云模式私有化模式
设备联网WiFi连接互联网连接空间内网WiFi
API地址api.thingboot.com自建服务器IP
数据流向经过芯步云端内网直连，数据不出空间
网络依赖需要互联网仅需局域网
适用场景快速部署大型空间、数据安全要求高

私有化配置要点

  • 设备支持配置5组WiFi网络，自动连接信号最强的网络

  • 需自建HTTP服务，所有API调用在内网完成

  • 支持自建消息服务器，接收设备状态回调

七、设备安装部署指南

7.1 安装要求

项目要求
安装方式标准86型底盒安装
工作电压100-250V AC（交流市电）
负载功率MAX 1000W（LED负载应小于300W）
网络要求WiFi 2.4GHz信号覆盖良好
安装空间底盒深度 ≥ 35mm

7.2 电磁锁接线示意

⚠️ 重要提醒：切记，请勿直接将电插锁接在出门开关上！具体接线方案请参照产品手册。

text

7.3 配网步骤

  1. 在芯步控制台「网络配置」中登记现场WiFi名称和密码

  2. 长按出门开关面板进入配网模式

  3. 设备成功配网后，指示灯停止闪烁并显示在设备列表中

八、常见问题与排障

问题可能原因解决方案
设备不在线WiFi信号弱检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
远程开门无响应设备离线/电磁锁故障确认设备在线状态，检查电磁锁接线
开门时间过短point参数设置不当增大point值至3000或5000毫秒
命令下发成功但门不开电磁锁供电不足检查电磁锁电源是否正常
无法初始化接线问题确保零火线正确接入
签名验证失败参数错误确认ts为秒级时间戳，签名公式为md5(md5(AppSecret)+ts)

九、总结

本方案基于芯步智能触摸墙壁复合出门开关，实现了共享办公空间的智能化门禁管理

能力实现的方式是
远程开门point先通后断命令实现一键开门
预约联动开门预约系统验证后调用HTTP API
批量闭店管理批量控制命令统一关电
门禁锁定状态保持功能防误入
远程运维reset命令远程复位
私有化部署内网运行，数据安全可控

集成核心步骤

  1. 获取AppID/AppSecret，实现MD5签名计算

  2. 开发HTTP调用模块，封装point开门命令

  3. 对接预约系统，实现开门权限验证

  4. 物理安装设备，注意电磁锁接线规范

方案优势

  • ✅ 复合功能：集门禁控制与设备管理于一体

  • ✅ 接口统一：标准HTTP API，10分钟完成对接

  • ✅ 即插即用：WiFi直连无需网关，可设定多组WiFi自动切换

  • ✅ 任意语言接入：Web、APP/小程序、SaaS平台均可对接

  • ✅ 私有化支持：数据安全可控，适合企业内网部署

  • ✅ 电子锁兼容：支持所有类型的电磁锁、电插锁

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。