芯步的智能通断器通过HTTP接口开放控制能力，适合集成到酒店PMS或客房管理系统中。以下方案围绕接口对接流程、签名算法、典型场景代码实现三个层面展开，你可根据实际软件开发环境选择对应语言参考实现。
解决方案：基于芯步开放接口的酒店客房照明控制集成方案
1. 概述
本方案的目标是指导开发者如何利用芯步 AC2-10A 智能通断器 的开放 HTTP API，将其无缝集成到酒店现有的软件管理系统（如 PMS、客房控制系统或微信小程序）中。
通过集成，酒店可以实现对客房灯光回路的远程控制、定时策略（如深夜节能）以及与传感器的联动（如插卡取电后自动亮灯）。
核心产品参数：
型号：UNI-TDQ-AC2-10A
负载：AC 220V，最大10A（约2200W），适用于酒店大部分照明及插座回路
网络：Wi-Fi 2.4GHz（直连，无需网关）
接口协议：HTTP/HTTPS（支持公网与局域网私有化部署）
2. 对接设计
在酒店场景中，推荐采用 “云端/本地服务器直控” 或 “边缘网关协同” 的架构。由于该设备无需网关，服务器可直接通过 HTTP 请求控制设备。
数据流向（控制命令）：酒店管理后台/App -> 酒店本地服务器/芯步云 -> WiFi网络 -> 智能通断器 -> 照明设备
数据流向（状态同步）：设备支持消息推送机制，当灯光状态发生变化（手动按键、遥控或电压异常恢复）时，设备会实时将状态推送到开发者指定的服务器 URL，确保软件界面与物理状态同步 。
3. 对接核心步骤
3.1 前期准备：获取密钥
在芯步开发者控制台获取以下凭证，用于接口鉴权
AppId：应用的唯一标识。
AppSecret：开发者密码，用于生成签名。
3.2 接口鉴权（签名机制）
芯步的 API 采用动态签名验证，防止接口被恶意篡改。签名生成算法逻辑如下：
先对
AppSecret进行一次 MD5 加密：secret_md5 = md5(AppSecret)拼接时间戳：将当前Unix时间戳（秒，即
ts）拼接到上一步得到的字符串后：sign_str = secret_md5 + ts再次 MD5：对拼接后的字符串再次进行 MD5 加密，得到最终签名：
sign = md5(sign_str)
请求地址格式：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
3.3 核心接口调用：下发控制命令
这是控制灯光开关的核心逻辑。你需要向 API 发送一个 POST 请求，JSON 格式的 Body。
关键参数定义：
device：设备ID（例如："1878"），可在控制台获取 。order：指令对象。开灯
{"power": 1}或{"power1": 1}（视具体固件版本，通常power后不加数字或加1代表第一路）。关灯
{"power": 0}。
3.4 实战代码示例
以下是如何在不同编程环境下下发“开灯”指令的具体实现：
示例 1：使用 Shell / cURL (适用于后端脚本)
示例 2：Java (适用于 Android 或后端服务)
示例 3：微信小程序 / 前端 JavaScript酒店管理人员或住客可通过手机操作，前端直接调用（需在服务器端代理签名，避免密钥泄露，此处展示前端请求格式）：
4. 酒店场景应用逻辑设计
利用 AC2-10A 的 API，可以设计如下酒店业务逻辑：
第一种场景：插卡取电联动
逻辑：客人插入房卡 -> 酒店传感器触发 -> 系统后台自动调用控制接口
{"power":1}发送给“客房总控通断器”或“走廊灯通断器”。效果：无需客人摸黑找开关，直接进入明亮房间。
第二种场景：离房断电与节能
逻辑：客人拔出房卡/退房 -> 酒店 PMS 系统触发离店事件 -> 系统调用
{"power":0}关闭所有受控通断器。效果：解决客人忘记关灯浪费电的问题。
第三种场景：定时/深夜模式
逻辑：定时任务（如每日凌晨 00:00） -> 定时脚本扫描所有空房 -> 批量发送关闭指令。
效果：确保空置房间完全断电，降低安全隐患。
场景四：场景化控制
逻辑：PAD 或面板触发“睡眠模式” -> 调用通断器接口关闭主灯，同时保持夜灯通路开启。
效果：提升住客智能化体验。
5. 状态同步与私有化部署
状态同步（回调机制）：为了保持 App 上的开关状态与物理按键状态一致，你需要在芯步控制台配置 “消息推送 URL”。当客人手动按下连接在通断器上的物理开关，或设备掉线重连后，设备会主动向该 URL 推送当前状态。
私有化部署（局域网方案）：对于高安全或网络不稳定的酒店，AC2-10A 支持局域网纯环境运行。你可以将请求 URL 中的域名替换为酒店内网服务器的 IP 地址。这样，所有控制指令仅在酒店内部网络传输，无需经过外网，响应速度更快（理论 < 50ms），且断外网时仍可控。
6. 总结
芯步 AC2-10A 智能通断器通过标准的 HTTP API 降低了硬件对接门槛。开发者只需关注 “签名计算” 和 “指令封装” 这两部分，即可在 1-2 天内完成基础照明控制的软件集成，快速为酒店客户提供稳定、低成本的智能化改造方案。