AC1-10A是一款支持HTTP接口的WiFi智能通断器，可独立运行无需网关。以下方案展示如何利用其开放API，在20分钟内搭建一套完整的场景联动系统——通过设备状态消息驱动其他设备响应，实现真正的自动化控制。
1. 解决概述
1.1 背景与目标
在许多商业场景（如共享自习室、无人棋牌室）或智能家庭中，仅仅能够远程控制单个插座是不够的。真正的需求在于“联动”：例如，当有人刷卡进入房间时，AC1-10A 自动接通电路；当湿度传感器检测到过于干燥时，自动加湿；或者当顾客超时未续费，自动断电。
本方案的目标是利用 芯步 提供的标准开放接口，将 AC1-10A 智能通断器无缝接入您现有的业务系统（小程序、APP或SaaS平台），实现基于事件驱动的场景联动。
1.2 硬件参数
产品型号：UNI-TDQ-AC1-10A
控制能力：1路继电器输出（最大支持10A/2200W阻性负载）。
网络支持：Wi-Fi 2.4GHz（无需额外网关，直连路由器）。
核心优势：支持HTTP/Websocket接口控制、状态实时反馈。
2. 技术设计
要实现“场景联动”，不能仅靠手机点击按钮发送命令，而应建立一个“触发-响应”的闭环系统。
设备层：AC1-10A（执行器） + 各类传感器（如人体传感器、门磁、第三方温湿度计）。
平台层：芯步开放API + 您的自建服务器（核心逻辑处理中心）。
应用层：您的业务系统界面或自动化规则引擎。
联动逻辑流程
状态上报：AC1-10A状态改变（如被物理按键按下）或外部传感器触发 -> 上报到云端。
消息推送：芯步平台通过HTTP回调，将设备状态推送给您的服务器。
逻辑判断：您的服务器根据预设的场景规则（例如：如果温湿度高于80%且设备为关闭状态，则执行开启）。
命令下发：服务器调用芯步开放API中的
device/control接口，向AC1-10A下发通断指令。
3. 接入实施步骤
3.1 准备工作：获取密钥与设备ID
首先需要在芯步控制台完成基础配置：
注册开发者账号并创建“工作台”。
在开发设置中获取 AppID 和 AppSecret（开发者密码），这是调用API的身份凭证。
将AC1-10A设备上电，使用配网小程序将其连接到Wi-Fi，并在控制台获取唯一的 设备ID (Device ID)，例如
1878。
3.2 配置联动“触发器”：消息推送机制
场景联动的关键在于 “被动接收通知” ，而不是“主动轮询”。在控制台中配置 HTTP 回调 URL（需填入您的服务器公网地址，例如 https://api.yourdomain.com/device/callback）。
触发逻辑：当AC1-10A的状态发生变化时，芯步平台会立即向该URL发送包含设备ID、当前状态、时间戳的JSON数据包。
作用：这是实现场景联动的核心。假设用户通过物理按键打开了AC1-10A，您的服务器收到“打开”的通知后，可以自动执行后续动作，如向用户微信发送通知，或联动打开摄像头。
3.3 核心API调试：下发控制命令
您需要在服务器端编写代码，调用API来控制设备的通断。
接口详情
地址
https://api.thingboot.com/{AppId}/device/control/鉴权方式：动态签名 (Sign)
签名生成逻辑为了防止接口被恶意攻击，芯步采用双重MD5加密。以 AppSecret 为 abc123，时间戳 ts 为 1714118400 为例：
计算
MD5(AppSecret)-> 结果e99a18c428cb38d5f22e03拼接并计算
MD5( (1的结果) + ts )->MD5(e99a18c428cb38d5f22e031714118400)。最终得到的字符串即为
Sign。
请求示例 (基于Python)
常用指令：控制通断使用 order={"power1": 1}；如果需要模拟点动模式（如自动灌溉，开5秒后关），则需要结合业务逻辑，在收到成功返回后等待5秒，再发送一次 order={"power1": 0} 命令。
4. 典型场景联动解决方案
4.1 第一种场景：无人棋牌室/自习室（计时通断）
需求：用户下单后，对应房间的电源自动通电。实施方案
将AC1-10A安装在房间总电箱或麻将机的插座回路中。
联动逻辑：用户在小程序支付成功 -> 您的业务系统调用API -> 向指定设备ID下发
{"power1":1}-> 电源接通。防作弊机制：启用消息推送，若检测到断电状态但订单仍在有效期内，系统自动补电或告警。
4.2 第二种场景：智慧农业/养殖（传感器闭环控制）
需求：当温湿度传感器检测到超过阈值时，自动开启排风扇或加湿器。实施方案
温湿度传感器（第三方或芯步生态）数据上报至您的服务器。
联动逻辑：服务器判断
湿度 < 30%-> 调用API控制AC1-10A闭合 -> 加湿器启动。当服务器收到传感器数据
湿度 > 60%时，再次调用API断开AC1-10A。
4.3 第三种场景：智能家居（红外/射频联动）
需求：关掉空调时，自动切断插座电源防止待机耗电。实施方案：利用AC1-10A的自定义信号输入功能。如果设备带有射频学习功能（需确认具体批次），可学习空调遥控器的关机码。当检测到红外信号时，自动触发继电器断电。
5. 最佳实践和需要注意的点
私有化部署考虑：芯步支持私有化部署。如果您的场景对网络延迟极其敏感，或者数据必须在内网流转，可以搭建本地消息服务器，让AC1-10A直接在局域网内通过HTTP与您的服务器通信（不经过外网），实现毫秒级联动。
超时与重试：在调用API时，网络可能会有波动。在您的联动逻辑中，若因网络原因命令下发失败，应设置重试机制（如间隔2秒重试3次），确保场景执行的可靠性。
批量控制：API支持一次请求控制多个设备。例如在“离家模式”场景下，可将
device参数写成"1001,1002,1003"，一条命令即可关闭整屋所有AC1-10A设备。并发处理：如果消息推送（回调）频繁触发（例如在1秒内收到了10个状态改变），您的服务器需要采用异步队列（如Redis或RabbitMQ）处理，防止线程阻塞。
通过以上步骤，您已将简单的AC1-10A通断器升级为可编程的自动化节点，完成了从 “人工遥控” 到 “全自动场景联动” 的跨越。