包间门禁联动的痛点是“人走电不断”和“远程难管控”——顾客离开后空调照明常开，商家需手动巡场断电。芯步4路控制器Mini的第3路专为电磁锁设计，配合HTTP接口可完美实现“开锁即通电、关锁即全断”的自动化流程。以下方案详细说明如何用接口调用来落地这套逻辑。
1. 背景与需求分析
在当前的共享棋牌室、茶室、影音房等服务业态中，包间管理的痛点在于“人离电未断”与“远程管控难”。传统的管理模式依赖服务员人工巡场断电，不仅人力成本高，且无法实现24小时无人值守运营。为了解决这一难题，我们需要将包间内的门禁系统与照明、空调、麻将机等电器设备进行联动控制。
芯步推出的智能包间控制器Mini（型号：UNI-KZQ-BJ-MINI）凭借其4路独立输出和开放的HTTP接口，成为解决这一需求的硬件。本方案的目标是详细阐述如何利用该控制器的开放API，实现“刷卡/扫码开门即用电，关门离店即断电”的全自动管理流程。
2. 硬件选型与功能定义
在制定对接方案前，首先需要明确智能包间控制器Mini的硬件特性。该设备专为服务型门店设计，其接口定义完美覆盖了包间用电场景。
2.1 设备接口定义
我们将4路输出做如下规划，以实现门禁与电器的逻辑联动的物理基础：
第1路（16A）：照明与换气系统。控制包间内的主照明灯、氛围灯带及排气扇。
第2路（16A）：娱乐与饮水设备。控制麻将机、饮水机、茶吧机等非空调类大功率电器。
第3路（10A）：门禁电磁锁（核心联动点）。此为直流输出接口，专门用于控制直流电磁锁或电插锁。通过控制此路的通断电，实现远程开门和关门落锁。
第4路（30A）：空调系统。控制2匹以内的空调挂机或柜机。
2.2 技术优势
直连无需网关：设备支持2.4G WiFi直连，无需购买额外的网关设备，降低了系统架构的复杂度。
接口通用性：采用标准的HTTP协议，无论您的管理系统是基于Java、Python、PHP还是Node.js开发的，均可无缝对接。
3. 系统对接设计
为了实现“联动管理”，我们需要将用户的小程序/公众号（作为控制端）、芯步云平台（作为设备代理）以及包间控制器（作为执行端）串联起来。
3.1 网络拓扑结构
设备端：包间控制器Mini通过WiFi连接到门店路由器，接入互联网。
云平台：芯步开放平台作为桥梁，负责处理API请求和设备状态推送。
业务服务器：商家的自建服务器，负责业务逻辑（如订单计时、计费）和调用控制器的API。
3.2 联动逻辑流程图
整个联动管理流程分为“入场”和“离开现场时”两个核心阶段：
入场阶段（开门即用）
用户在小程序端完成下单支付。
业务服务器收到支付成功回调。
服务器调用API向 第3路（门锁） 发送“断电”指令（注：电磁锁通常为断电开锁或通电开锁，需根据锁型配置，下文以常见的“通电上锁、断电开锁”为例说明逻辑）。
门锁断开，用户拉门进入。
联动策略：用户进入后，服务器调用API向 第1、2、4路 发送“通电”指令，灯光、麻将机、空调自动开启。
离开现场时阶段（人走电断）
用户在订单结束页面点击“退房/关门”，或订单计时归零。
服务器调用API向 第1、2、4路 发送“断电”指令，关闭所有电器。
服务器调用API向 第3路（门锁） 发送指令，落锁。
保洁模式：保洁人员可通过管理端临时开启第1路照明进行打扫，打扫完毕后一键关闭。
4. 关键对接技术实现
本部分将重点描述如何通过芯步的开放接口实现上述控制逻辑。
4.1 准备工作
在开始编码前，需在芯步控制台获取以下凭证
AppID：开发者ID，用于标识您的应用。
AppSecret：开发者密码，用于生成签名。
Device ID：设备的唯一ID（可在控制台查看或通过接口拉取）。
4.2 API接口调用规范
所有控制指令均通过向 https://api.thingboot.com/{AppID}/device/control/ 发送POST请求实现。
签名机制（Sign）为了安全性，每次请求需携带签名。签名计算规则为Sign = md5( md5(AppSecret) + ts )（其中ts为当前Unix时间戳）
4.3 核心命令示例（订单状态触发）
以下以 “用户下单成功后开启包间内所有设备” 的场景为例，展示具体的对接细节。
第一种场景：用户下单，开启包间服务（入场逻辑）
目标：开门（第3路断电），开灯/开空调（第1、4路通电）。
命令（Order JSON）
代码实现逻辑（伪代码）
第二种场景：用户退单，全屋断电（离开现场时逻辑）
目标：关闭除门锁外的所有电器。
命令：使用批量控制指令
batch提高效率。
随后系统延时5秒，再发送“关锁”指令：
4.4 高阶联动：语音播报与异常告警
如果选用 TTS语音版本，还可以利用其语音播报功能提升用户体验。
场景：当用户远程开门失败或订单即将到期时。
命令
这不仅能提醒用户，还能减少人工客服介入的成本。
5. 部署实施与安全管理
5.1 设备安装与配网
强电接入：请由专业电工操作，将控制器串联进包间总闸的后端。第3路（门禁）需单独引出直流电源接电磁锁。
配网流程：设备上电后，通过芯步提供的配网工具（或SDK集成到您的App中），将设备配置到门店的WiFi网络中。
网络：必须确保WiFi信号强度（RSSI值大于-60dBm），2.4G频段避免信道拥堵，以保证指令送达的实时性。
5.2 状态同步与异常处理
由于继电器操作存在“粘连”风险或网络断连可能，业务系统定期做状态同步：
心跳机制：每隔5分钟调用
device/status接口读取设备当前各路开关的实际状态。断网保护：若路由器断网，控制器维持最后一次指令状态。可在本地部署边缘网关或利用控制器的“定时任务”功能（预设每晚23:59全关）作为保底策略。
6. 方案价值总结
通过对接芯步4路包间控制器Mini，可以实现：
无人化值守：顾客线上自助下单，系统自动配电解锁，退房自动断电锁门，彻底告别前台。
精细化能源管理：杜绝“空调开着没人关”的浪费现象，第4路的30A高负载直接控制空调，无需额外加装交流接触器，单路可省电30%以上。
极低的改造成本：无线WiFi方案避免了复杂的综合布线，特别适合存量包间（棋牌室、茶室）的智能化改造。
可扩展性：后续可通过同一套API接口，将店内的广告屏、背景音乐等设备也纳入集中控制，形成完整的物联网SaaS解决方案。