AC4-30A是一款支持HTTP接口远程控制的智能通断器，可接入各类软件平台实现场景联动。以下方案涵盖设备配网、接口签名计算、命令下发及典型联动场景。
1. 产品概述与核心能力
芯步 AC4-30A 是一款支持大功率（最大6600W）的智能通断器，广泛适用于工业设备、商业照明、智能家居等场景。其核心开放能力如下：
全开放HTTP API接口：支持任意支持HTTP请求的编程语言（Java, PHP, Python, Node.js等）或SaaS/低代码平台接入。
远程与本地控制：既支持通过公网云端下发指令，也支持局域网内直接控制（私有化部署），响应速度约80-120ms。
命令多元化：不仅支持简单的“开/关”，还支持“定时开关”、“先通后断”、“先断后通”等脉冲式控制逻辑，满足复杂场景联动需求。
2. 接入准备
在开始编码开发前，需要完成硬件配网及密钥获取。
2.1 硬件配网
确保设备处于2.4G Wi-Fi信号覆盖范围内，接通AC4-30A电源。
注册与登录：访问芯步官方控制台注册账号。
设备配网
PC端：进入“物联网控制台” -> “网络配置”，登记现场2.4G Wi-Fi的SSID和密码，点击“为设备配置此网络”。随后用手机开启同名热点引导设备联网。
手机小程序端：微信搜索“芯步小程序”，登录后在“工作台”中添加Wi-Fi信息，按提示完成配网。
获取凭证：配网成功后，在控制台的“开发设置”中查看 AppID 和 AppSecret（开发者密码），在“设备列表”中获取 Device ID（设备唯一ID）。
2.2 场景联动架构
为实现场景联动，通常采用 事件驱动架构
触发源：传感器（人体红外、温湿度）、定时任务、其他设备状态。
执行引擎：您的业务服务器（或SaaS编排系统）。
执行器：AC4-30A。
流程：触发源产生信号 -> 业务服务器执行联动逻辑（如判断温度>30度） -> 调用API向AC4-30A下发指令。
3. API接口调用详解
AC4-30A的核心控制接口采用标准的HTTP POST方法。
3.1 签名机制（Sign）
为了防止接口被篡改，所有请求必须在URL参数中携带签名。计算公式如下
Sign = MD5( MD5(AppSecret) + ts )
参数说明
AppSecret：开发者密码。ts：当前Unix时间戳（秒级）。
计算步骤示例（伪代码）
step1 = MD5(AppSecret)// 第一次MD5加密step2 = step1 + ts// 拼接时间戳sign = MD5(step2)// 第二次MD5加密
3.2 请求地址与Header
请求URL
https://api.thingboot.com/{AppID}/device/control/Query参数
?sign={计算好的sign}&ts={当前时间戳}Content-Type
application/json
3.3 核心命令参数
AC4-30A支持以下三种主要控制模式，通过order参数传递
| 控制模式 | order JSON 格式 | 功能描述 | 典型场景 |
|---|---|---|---|
| 基本开关 | {"power":"1"} (开) {"power":"0"} (关) | 立即改变继电器状态 | 远程手动控制、联动触发开/关 |
| 先通后断 (点动) | {"point":"3000"} | 立即接通，延时后自动断开 | 控制闸机开门（3秒后自动关门）、控制水泵短暂启动 |
| 先断后通 (重启) | {"reset":"5000"} | 立即断开，延时后自动恢复 | 路由器/监控摄像头故障自动重启 |
3.4 请求示例
假设：AppID=abc123，Device ID=820720，需要控制设备打开。
Request Body:
完整cURL指令
4. 场景联动方案实战
基于上述接口，以下是三个典型场景的落地逻辑：
4.1 第一种场景：环境温湿度联动（恒温恒湿控制）
需求：当仓库温度过高时，自动排风；温度恢复后自动停止。逻辑开发
数据采集：服务器定期读取温湿度传感器数据。
条件判断：若温度 > 35℃，则调用控制接口。
指令下发
打开：
{"power":"1"}保持运行，直到温度低于30℃。
关闭：
{"power":"0"}
保护机制：配合
reset指令，防止传感器失效导致设备长时间运行。
4.2 第二种场景：安防报警联动（灯光震慑）
需求：红外探测器检测到入侵时，现场灯光（接AC4-30A）快速闪烁进行威慑。逻辑开发
触发器：接收红外报警Webhook。
联动逻辑
循环3次
开灯：
order={"power":"1"}等待500ms
关灯：
order={"power":"0"}等待500ms
结束循环。
最终保持常亮或恢复到警戒状态。
接口优化：此场景对实时性要求高，将AC4-30A与服务器置于同一局域网，使用局域网API地址（私有化）以降低延迟。
4.3 第三种场景：多设备群控
需求：一键启动“影院模式”，关闭灯光、幕布下降（AC4-30A控制）、投影机通电。逻辑开发AC4-30A接口支持一次请求控制多个设备，只需在device参数中用英文逗号分隔。
4.4 场景四：自动化定时任务
需求：每天22:00关闭广告牌灯光，次日6:00开启。开发方式
方式A（云定时）：如果您的业务系统具备定时任务功能（如Linux Crontab、SchedulerX），直接配置定时调用API即可。
方式B（设备硬件定时）：利用芯步控制台自带的“远程定时任务”功能，无需服务器即可在设备固件层面精确执行。
5. 开发集成
5.1 多语言代码片段
Java (OkHttp)
微信小程序 (wx.request)
5.2 异常处理策略
设备离线：接口返回特定错误码。设计“重试队列”，延迟重试。
网络抖动：设置超时时间（5s），配合调用机制设计（防止重复执行
point指令）。签名过期：为了避免重放攻击，请一定要校验
ts参数的有效性（如误差不超过5分钟）。
6. 总结
芯步AC4-30A 通过标准HTTP接口极大降低了物联网硬件的集成门槛。开发者无需关心底层MQTT协议的复杂实现，只需关注业务逻辑，通过简单的RESTful API调用即可将物理设备无缝融入数字孪生或自动化系统中。对于高安全性（金融、医疗）场景，可购买私有化部署版本，将控制流完全封闭在局域网内运行，保障数据安全。