CATALOG

芯步的智能硬件以“HTTP接口直控”为核心特色,相比ZigBee方案需网关透传,其命令下发延迟仅80-120ms,非常适合共享办公场景中高频、实时的门禁联动需求。以下方案围绕“接口如何配置、逻辑如何编排”展开。

1 背景与需求分析

共享办公空间由于其流动性高、灵活性强、入驻企业多样化的特点,传统门禁管理面临着诸多痛点:租期与权限更新不同步导致的安防漏洞、会议室使用与门禁互不联通的效率低下、以及公共区域能耗管理的缺失。运营方亟需一套能够实现身份识别、权限管控、设备联动三位一体的智能管理系统。

芯步提供的智能硬件产品(如智能墙壁出门开关、智能密码门禁等)具备全面开放的HTTP接口,这使得门禁系统不再是一个信息孤岛,而是可以作为一种触发源或执行器,深度融入共享办公的自动化控制逻辑中。本方案的目标是利用芯步设备的API特性,构建一个支持自定义联动规则的高灵活度门禁管理体系。

2 设计

本方案的设计遵循“云-管-边-端”的分层原则,确保系统的高可用性和低延迟响应。

在云端层,共享办公的SaaS管理系统作为核心大脑,负责处理业务逻辑,包括会员资格校验、权限计算以及联动规则的编排。通信层采用HTTP/HTTPS协议,利用芯步开放的API接口作为桥梁,管理系统无需关心底层硬件协议,只需通过标准的POST请求即可实现对设备的控制。边缘层是指部署在共享空间现场的本地服务器或高性能网关,当公网不稳定时,本地服务器可缓存指令并执行紧急逻辑(如消防联动),保障业务不中断。终端层部署各类芯步智能硬件,包括控制电磁锁的智能出门开关、触摸式密码门禁以及带功率计量的智能插座,这些设备通过Wi-Fi 2.4G直接联网,无需额外网关,降低了网络故障点

3 硬件选型与接口能力

基于共享办公不同场景的安全等级和使用频率,选用以下几款芯步核心产品,并利用其接口特性实现定制化功能。

首先是智能密码门禁[触摸],该设备用于独立办公室或会议室主入口,支持密码和远程双重验证。其关键接口能力是远程下发密码与永久禁用的指令——当租约到期时,系统只需调用删除密码接口,即可瞬间收回权限,解决了传统机械钥匙难以管理的难题。其次是智能墙壁出门开关,用于控制电磁锁的通断电,特别适用于需要“超级管理员”远程开门或紧急疏散的场景。该设备支持定时通断指令,例如调用命令{"device":xxxx, "order":{"reset":5000}}即可实现断电开门5秒后自动复位上锁。最后是带功率计量的智能插座,虽然它不直接控制门锁,但在联动逻辑中扮演关键角色。例如,当检测到空间总功率低于阈值(无人用电)并持续30分钟后,可反向联动门禁系统确认是否有人忘记关门或存在异常留宿。

以下是这三类核心设备的接口能力对比:

设备类型核心功能关键接口参数应用场景
智能密码门禁身份验证与电锁控制设备ID、密码列表、禁用指令实现远程权限发放与回收,支持临时访客密码
智能出门开关继电器通断控制设备ID、reset定时复位参数实现紧急远程开门、延时自动闭锁(防尾随)
计量型智能插座电量监测与通断电压/电流实时读数、功率阈值告警通过能耗曲线判断空间占用状态,实现节能联动

4 自定义联动逻辑实现方案

基于上述硬件与接口,本方案重点解决共享办公中三个典型的自定义联动场景。

4.1 第一种场景:基于“预约-门禁”的自动授权逻辑

在共享办公场景中,会议室或工位的使用权往往与客户的预约时段强相关。传统操作需要人工发卡,效率低下。

通过芯步的HTTP接口,开发者可以实现全自动的授权闭环。当用户在微信小程序或企业Web端预订会议室并支付成功后,系统触发一个回调函数。该函数通过读取订单中的StartTimeEndTime字段,计算出只有在该时间段内有效的通行时间窗。接着,系统向芯步API构造请求:https://api.thingboot.com/{AppId}/device/control/,携带签名Sign、时间戳Ts以及目标设备ID,下发一个仅在该时段有效的临时密码或权限指令。用户到达现场时,直接输入密码或点击门禁上的“远程开门”请求,即可进入。时段结束后,系统自动执行权限回收,全程无需前台介入,通过接口调用响应时间仅80-120毫秒,用户体验极佳

4.2 第二种场景:基于“门禁-能耗”的智能节能逻辑

共享办公空间最浪费能源的情况往往是“人走未关灯”或“区域内无人但空调未关”。本方案利用芯步计量插座的功率反馈功能实现反向控制。

当最后一个用户通过门禁系统刷卡离开某独立办公区时,门禁设备向服务器上报一次“出门”事件。服务器接收到该事件后,不是立即执行断电,而是启动一个自定义的“延时巡检任务”。系统会向该房间内的智能插座API查询实时功率数据。如果连续3次查询(间隔5分钟)功率均低于设定的待机阈值,则判定该区域确实无人。此时,系统主动调用智能插座的关闭命令,切断饮水机、照明或非必要空调的电源,实现精细化管理。这不仅节约了能源,还延长了设备寿命。

4.3 第三种场景:消防与安防的全域联动逻辑

共享空间人员密集,安全是运营的红线。芯步设备支持私有化部署和局域网控制,非常适合高可靠性的安防联动

系统可以通过API订阅第三方烟感或消防主机的报警信号。一旦接收到火警信号,管理后台将启动高优先级线程,忽略所有常规的业务锁逻辑。具体联动表现为:系统遍历该区域下的所有智能出门开关设备,批量发送{"reset": 0}或特定开门指令,强制切断所有电磁锁电源,确保逃生通道物理畅通。同时,系统在后台自动生成疏散报告,记录从报警到所有门禁释放的时间差,用于后续的安全审计。这种逻辑确保了在紧急情况下,网络延迟或服务器负载都不会影响逃生的及时性。

5 实施流程与接口对接指南

为了帮助开发者快速落地上述方案,以下是实施过程中的关键步骤。

首先是设备部署与激活。在共享空间各点位安装芯步智能硬件(如86型墙壁开关可直接替换传统开关)。设备通电后,通过配网工具将其连接至本地2.4G Wi-Fi网络。设备联网后,在芯步管理后台获取每个设备唯一的Device IDAppKey,这是后续API调用的凭证。

其次是权限与签名构建。所有API调用都需要进行身份验证,以保证数据传输安全。开发者需在后端服务中实现签名算法(如MD5HMAC),将AppIdDevice ID、时间戳ts和密钥拼接后生成签名sign。最终的请求URL格式为:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts},请求体为JSON格式,包含设备指令

最后是业务逻辑集成。开发者无需自行维护复杂的设备状态同步,只需在现有的共享办公SaaS系统中增加一个“物联中台”模块。该模块负责接收业务层的事件(如“新订单支付成功”),并将其翻译为标准化的芯步HTTP指令下发。设置指令队列和重试机制,以应对网络抖动,确保“命令必达”。

阶段操作内容关键产出/工具
硬装部署替换传统面板、安装门禁、配网绑定设备ID列表、稳定的Wi-Fi覆盖
接口开发实现Sign签名算法、封装POST请求API验签模块、设备控制服务类
逻辑编排配置预约时间窗与设备动作的映射关系自动化规则引擎、事件触发器

6 方案优势与运营价值

通过接入芯步开放接口,共享办公空间能够获得显著的成本优势。由于支持Wi-Fi直连,相比传统RS485有线门禁或ZigBee方案,无需布设专门的网关和通讯线缆,改造成本极低,且利用墙面86盒直接替换可实现无损安装

在管理效率方面,实现了权限的“即买即通、即退即断”,大幅降低了因交接不及时导致的安全风险。从用户交互体验来看,用户通过微信小程序即可完成预约、通行、控灯等全流程,无需携带实体卡,科技感强。

此外,该方案具备极强的可扩展性。由于采用HTTP标准协议,未来不仅能控制门禁,还能无缝接入共享空间的智能饮水机、智能快递柜等其他设备,真正实现一个平台、一个账号管理整个物理空间,为共享办公运营方构建强大的物联网数据资产