AC4-10A智能通断器支持HTTP API接口，可通过云端或局域网直接调用，实现与其他传感器的场景联动。以下方案涵盖设备接入、接口调用和联动逻辑设计的完整流程。
1. 场景概述与目标
在许多智能商业和工业场景中，单一的设备控制往往不能满足复杂的自动化需求。例如：
环境联动：当会议室温度过高时，自动启动排风扇（接入AC4-10A）。
安防联动：当烟雾传感器报警时，自动切断非消防电源（接入AC4-10A）。
节能策略：当人体传感器检测到无人时，自动关闭灯光或广告牌电源。
本方案的目标是指导开发者如何利用芯步开放平台及智能通断器AC4-10A的开放接口（HTTP API），将这款额定功率2000W的通断器快速接入现有的第三方系统或自研平台，实现基于传感器数据的场景联动。
2. 核心准备工作
在开始编码和接线之前，请确保完成以下硬件与软件层面的准备：
| 准备项 | 要求/规格 | 说明 |
|---|---|---|
| 硬件设备 | 智能通断器AC4-10A | 支持2.4G WiFi频段，无需额外网关 |
| 被控电器 | 总额定功率 ≤2000W | 阻性负载，如照明、风扇、水泵等 |
| 网络环境 | 稳定的2.4G WiFi | 设备不支持5G频段，需现场信号覆盖良好 |
| 开发账号 | 芯步官方账号 | 用于获取AppID、AppSecret及设备ID |
| 开发环境 | 支持HTTP协议的任意语言 | Python/Java/Node.js/PHP及小程序均支持 |
3. 设备配网与激活
AC4-10A采用“SoftAP+手机热点”的方式进行配网，俗称“热点配网”或“Combo配网”，这是该系列产品的典型设置流程。
操作步骤如下：
上电与重置：确保断路器电源关闭并接线完毕，然后上电。长按设备上的按钮，直到指示灯进入快速闪烁状态（通常为每秒两次），表示设备进入等待配网模式（AP模式）。
注册与创建应用
访问芯步官网，注册账号。
进入“工作台” -> “物联网控制台”，安装“物联网控制台”模块（若未安装）。
创建您的应用，获取唯一的 {AppId}，后续所有API调用均需使用。
执行配网
电脑端操作：在控制台的“网络配置”中，点击“登记网络”，输入现场路由器的2.4G WiFi名称和密码。点击“为设备配置此网络”。
根据提示操作手机：此时系统会提示将手机的“个人热点”名称和密码修改为刚才输入的WiFi名称和密码（注意：不是让设备连手机热点，而是利用手机热点功能将凭证传输给设备）。
观察设备：当指示灯变为常亮或呼吸状态，表明配网成功，设备会出现在控制台的设备列表中。
获取设备ID：在控制台设备列表中，记录下这台AC4-10A的
device编号，这是后续控制指令的目标地址。
4. 开放接口详解：控制与联动
芯步的开放接口基于HTTP协议，请求地址为：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
核心鉴权参数
AppId：由平台直接颁发的应用ID。
ts：Unix时间戳，用于防止重放攻击。
sign：签名，根据AppSecret和ts通过MD5等算法加密生成（需查阅官方签名文档）。
4.1 关键指令：控制设备通断
AC4-10A的核心功能是继电器控制。由于它是单路控制，命令较简单。
请求方法：POST
请求头 (Header)：Content-Type: application/json
请求体 (Body)
| 功能 | JSON参数 (order) | 说明 |
|---|---|---|
| 开启电器 | {"power": 1} | 闭合继电器，线路接通 |
| 关闭电器 | {"power": 0} | 断开继电器，线路断开 |
| 临时开启 (点动) | {"point": 3000} | 立即通电，3000毫秒后自动断电 |
| 临时关闭 (复位) | {"reset": 5000} | 立即断电，5000毫秒后自动恢复通电 |
代码示例 (Python Flask 风格)
4.2 联动实现机制
要实现场景联动，需要配合传感器。以“人体传感器检测到有人开灯”为例：
数据上行：芯步支持消息推送。在控制台配置您的服务器回调URL。当传感器状态变化时，平台会主动推送数据到您的服务器。
逻辑判断：您的服务器接收传感器消息（如
{"device": "sensor_01", "status": "someone_move"}）。指令下行：服务器触发联动逻辑，调用上述
control_device(1)接口，向AC4-10A发送开启命令。
5. 局域网与私有化部署（进阶）
对于对延迟敏感或数据安全要求高的企业场景，AC4-10A支持局域网HTTP API控制和私有化部署。
局域网控制：如果AC4-10A与您的服务器处于同一局域网段，可以直接使用设备IP地址代替云API地址进行控制，响应速度可降至毫秒级（80-120ms），且不依赖外网带宽。
私有化：芯步支持将整个物联网平台打包部署在企业内网的服务器上，实现数据物理隔离。
6. 最佳实践：空调联动场景案例
需求：在办公室部署了空调（接入AC4-10A）和温湿度传感器。当温度 > 28℃ 且 传感器检测到有人时，自动开启空调电源（空调已调至制冷模式）；当无人时，自动断电。
实施步骤
接线：将空调插头插入AC4-10A的输出端，AC4-10A接入墙壁插座。
配网：将AC4-10A和温湿度传感器均配网接入开发者后台。
设置服务器接收
订阅温湿度传感器的实时上报数据。
订阅人体传感器的状态数据。
编写核心逻辑（伪代码）
7. 注意事项与排障指南
WiFi频段问题：若配网屡次失败，绝大多数情况是由于手机或路由器开启了双频合一（2.4G/5G混合）。在路由器后台暂时关闭5G WiFi，或确保手机断开5G WiFi，仅连接2.4G WiFi进行配网操作。
功率限制：AC4-10A最大支持2000W。如果是电机类（感性负载），启动电流较大，降额使用或选用AC4-20A型号。
设备唤醒：设备采用WiFi实时在线机制，无需唤醒，只要联网即可瞬间响应命令。
按钮屏蔽：在无人值守场景下，可以在代码中通过命令屏蔽设备上的物理按钮，防止现场人员误触导致联动失效。
通过以上步骤，您可以实现“传感器上云 -> 数据分析 -> 通断器动作”的全链路场景联动控制。