芯步的智能触摸墙壁开关3路通过HTTP接口开放控制能力，可集成到Web、小程序、桌面应用等各类项目中。以下是完整的集成方案，涵盖签名鉴权、命令格式和典型联动场景。
办公设备照明联动解决方案：集成智能触摸墙壁开关3路
1. 概述
本方案的目标是指导开发者如何利用芯步提供的开放HTTP API接口，将 “智能触摸墙壁开关3路” 集成到自有办公系统（如OA系统、智能中控平台或园区管理平台）中。
通过集成，可实现办公区域的照明设备、排风扇等办公电器的远程集中控制、定时策略执行以及与传感器（如人体传感器、光照传感器）的自动化联动。该方案基于标准HTTP协议，兼容性强，支持公网与局域网（私有化部署）环境 。
2. 硬件与接口特性
硬件型号：智能触摸墙壁开关3路 (型号：UNI-KG-CM-3) 。
控制能力：支持3路独立控制（通常对应3组照明线路或小型电器）。
通信方式：Wi-Fi 2.4GHz直连，无需额外网关 。
接口协议：HTTP/HTTPS POST请求。
响应速度：命令下发到设备动作响应约为 80-120ms 。
3. 集成准备工作
在编写代码前，需要获取以下三个关键凭证：
AppId (应用ID)：在芯步控制台创建项目后获取。
AppSecret (开发者密码)：在控制台的“开发设置”中获取，用于签名计算 。
Device ID (设备ID)：在控制台设备列表或设备外壳标签上获取。
安全说明所有API调用均需携带动态签名（Sign），防止接口被恶意伪造调用。签名算法规则如下
其中 ts 为当前的Unix时间戳（秒）。
4. 接口集成步骤
4.1 鉴权与请求地址
请求URL格式如下：
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}Method： POST
Content-Type： application/json
4.2 签名计算示例 (伪代码)
4.3 下发控制命令 (Request Body)
在请求体中通过 order 参数携带指令。
基础三路开关指令
| 操作场景 | JSON 命令示例 (order) | 说明 |
|---|---|---|
| 开启第1路 | {"power1": 1} | 控制继电器吸合，灯光亮起 |
| 关闭第2路 | {"power2": 0} | 控制继电器断开，灯光熄灭 |
| 开启所有路 | {"power1":1, "power2":1, "power3":1} | 一次性控制全部3个回路 |
| 第3路点动 | {"point3": "2000"} | 第3路通电2秒后自动断开（适用于排气扇延时关闭） |
进阶场景指令
| 功能 | 命令示例 | 适用场景 |
|---|---|---|
| 状态保持 (锁定) | {"power1": {"keep":"1","revert":"3"}} | 管理员锁定某路线路，用户手动关闭3秒后自动恢复开启（如会议室强制照明） |
| 先断后通 (复位) | {"reset2":"5000"} | 网络设备故障远程重启（断开5秒后重新通电） |
4.4 集成代码示例 (cURL)
5. 联动场景：以“办公照明节能”为例
结合芯步生态中的传感器，通过在自有服务器侧编写逻辑，实现真正的“去网关化”智能联动 。
场景描述：当人员离开工位区超过10分钟，自动关闭该区域照明开关（第3路）。
系统集成逻辑流程
数据源接入：服务器接收来自“智能人体存在传感器”的数据（通过消息推送机制）。
逻辑判断
IF 传感器状态 = "无人" AND 持续时间 > 10分钟 THEN 触发关闭动作 END IF指令下发：调用芯步API。
6. 高级集成技巧
私有化部署 (局域网)：对于高安全要求的涉密单位，芯步支持私有化部署。只需将所有API请求的域名指向内部服务器地址，设备配置内部MQTT Broker或HTTP地址即可，全程数据不出园区 。
设备状态同步：除了主动控制，需订阅设备状态变更消息。当员工手动触摸墙壁开关时，设备会主动上报状态变化。你的系统需要维护一个WebSocket或HTTP回调接口来接收这些实时状态，以保持UI界面与控制台的数据一致性。
7. 总结
通过集成芯步智能触摸墙壁开关3路，你可以快速赋予传统办公设备“在线”能力。整个集成过程无需底层嵌入式开发，仅需按照上述文档处理 HTTP请求、签名认证 及 命令格式，即可在数小时内完成从硬件上电到业务系统控制的全流程打通。