芯步智能3路墙壁开关开放了完整的HTTP API接口，支持独立控制三路电路、状态保持、先通后断等高级指令。以下方案详细说明如何对接这些接口，实现从签名鉴权到自定义场景联动的完整流程。

一、 解决概述

本方案的目标是指导开发者或集成商，利用芯步提供的标准HTTP API接口，将“智能3路墙壁开关”集成到第三方或自定义的管理系统中，从而打破品牌限制，实现高度灵活的“自定义场景联动”。

核心技术点：

• 接口协议： HTTPS (POST/GET)

• 数据格式： JSON

• 鉴权方式： 动态MD5签名

• 核心优势： 支持局域网IP直连和云端API两种模式，具备比较高的响应速度和内网安全性。

二、 对接准备与鉴权

在开始编码前，需在芯步控制台完成准备工作，这是所有API调用的安全基础。

1. 获取凭证： 登录芯步工作台，在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。

2. 设备ID： 确保智能3路墙壁开关已配网并在线，在控制台设备列表获取 device（设备唯一ID）。

3. 签名计算： 为防止接口被恶意篡改，每次请求需携带动态签名 sign，算法逻辑为：

   • Sign = md5( md5(AppSecret) + ts )

   • 其中 ts 为当前Unix时间戳（秒级）。具体来说，先将 AppSecret 进行一次MD5加密得到字符串A，然后将字符串A与时间戳拼接，再对整个字符串进行MD5加密得到最终签名。

三、 核心接口调用：实现对三路电路的精细控制

“智能3路墙壁开关”最核心的能力是独立控制三路电路，支持控制开/关、状态保持、点动/脉冲等高级功能。

1. 基础控制（开/关/暂态）

用于直接切换电器的通断电状态，例如开关灯、开关排风扇。

• 接口地址：https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• 请求方式： POST

• 请求头：Content-Type: application/json

• 三路独立指令示例：

  • 控制第1路打开：

    { "device": "设备ID"， "order": {"power1": 1} }

  • 控制第2路关闭：

    { "device": "设备ID"， "order": {"power2": 0} }

  • 控制第3路打开：

    { "device": "设备ID"， "order": {"power3": 1} }

2. 高级控制（场景联动的核心）

自定义场景往往需要设备在特定时间内自动恢复状态，而非固定常开或常关。

• 状态保持（锁定）： 适用于“暂态按键”场景。例如用户手动按下开关关灯，3秒后灯自动又打开；或者用户开灯，2秒后自动关闭（走廊灯控制）。

  • 场景需求： 用户误关了插座，但设备需保持供电 -> 用户关闭第1路后，3秒自动恢复打开。

  • 下发指令：{“power1”： {“keep”： “1”， “revert”： “3”}} （keep:1代表保持开，用户关后等待revert秒恢复）

• 先通后断（点动/脉冲）： 适用于控制门禁按钮或卷帘门电机。即瞬间给一个“接通”信号，持续2秒后自动断开。

  • 场景需求： 按一下门禁开关，通电1秒触发开门信号。

  • 下发指令：{“point1”： “1000”} （单位：毫秒）

• 先断后通（复位）： 适用于设备重启或复位操作。

  • 场景需求： 重启路由器（断开电源5秒后重新上电）。

  • 下发指令：{“reset1”： “5000”}

四、 自定义场景联动实战

利用上述API，结合后端逻辑（如Node-RED、HomeAssistant、PHP等），可以实现复杂的自定义联动。以下是两个典型的实战场景：

第一种场景：离家模式（一键全关/全开）

当用户离家时，触发“离家模式”，一键关闭家中所有灯光（假设灯接在第1、2路）。

• 触发条件： 用户点击App中的“离家模式”按钮或语音指令。

• 执行逻辑： 依次或并发调用API执行以下指令。

• 关键代码逻辑思维：

  // 关闭设备"switch_001"的第1路、第2路 { "device": "switch_001", "order": { "power1": 0, "power2": 0 } }

第二种场景：人来灯亮与延迟熄灭（楼梯/卫生间联动）

利用人体传感器联动开关。当传感器触发（人来了），开灯；传感器恢复（人走了），延时30秒关灯。

• 触发条件： 传感器状态由“无人”变为“有人”。

• 执行逻辑： 调用API开灯。

  { "device": "stair_light", "order": { "power1": 1 } }

• 触发条件： 传感器状态由“有人”变为“无人”。

• 执行逻辑： 调用API利用“先通后断”或“状态保持”功能，或由业务服务器计时30秒后发送关闭指令。

  • 推荐指令：{ “device”： “stair_light”, “order”： { “reset1”： “30000” } } （如果支持长延时，否则由云端计时下发{“power1”：0}）

五、 架构与部署模式

为了提升响应速度和系统稳定性，芯步的这类硬件支持两种集成模式：

1. 云端SaaS模式（公网）：

   • 适合分布式、跨区域的管理系统。

   • 设备连接芯步全球云服务器，您的业务服务器通过调用云端API（api.thingboot.com）下发指令。此模式无需公网IP，维护简单。

2. 局域网/私有化模式：

   • 适合对响应速度要求比较高（工业控制）、或对数据隐私要求严格的场景（政府、酒店内网）。

   • 芯步设备支持局域网搜索和直连。您的控制软件可以直接通过HTTP请求设备本地的IP地址（在局域网内）进行控制，不经过云平台，即使外网断开也能正常使用。

六、 总结

对接芯步“智能3路墙壁开关”以实现自定义场景联动，本质上是对其 power1/power2/power3 三个核心属性的灵活编排。开发者只需掌握 MD5签名机制 和 JSON指令格式，即可在15分钟内实现基于HTTP协议的原生控制。

无论是构建复杂的“回家/离家”场景，还是通过传感器联动的精细化节能方案，智能3路开关的开放API接口、状态保持（锁定）功能及局域网直连特性，都提供了足够的底层支持来满足各类商业和工业需求。