AC2-10A 是芯步推出的一款支持 HTTP 接口控制的智能通断器，适合需要将用电数据采集与远程控制集成到自有软件系统的场景。以下是完整的接入方案，涵盖硬件准备、设备配网、接口调用、消息推送接收及高级功能实现。
1. 概述
本方案的目标是指导开发者或系统集成商，通过调用芯步提供的开放 API 接口，实现对 AC2-10A 智能通断器的远程控制（开/关）、状态监测以及用电数据（继电器状态）的上报接收。
适用场景：
远程控制广告灯箱、照明设备、饮水机等。
共享设备控制（如自习室座位电源、充电桩）。
工业或农业物联网远程控制。
技术优势：
无需网关：设备直连 WiFi 2.4G。
接口简单：标准 HTTP POST 请求，支持任何开发语言（Java, Python, PHP, Node.js 等）。
实时反馈：设备状态变化实时推送到开发者指定的服务器 URL。
2. 准备工作
在开始开发前，请确保完成以下硬件与账号配置：
硬件准备
芯步 AC2-10A 智能通断器一台。
2.4GHz 频段的 WiFi 网络（不支持 5G）。
220V 交流电源测试环境（注意用电安全）。
软件账号
注册芯步官方账号。
登录控制台，获取
AppID和AppSecret（开发者密码），这是后续接口调用的凭证。
3. 设备配网（连接互联网）
AC2-10A 首次使用需要接入本地 WiFi。您既可以使用官方小程序快速配置，也可以通过控制台进行“SoftAP”配置。
推荐方案：使用“芯步”小程序（最快）
微信搜索“芯步”小程序。
登录您的账号（需与官网控制台账号一致）。
点击右上角“+”添加设备，选择“智能通断器”。
根据提示，输入当前环境的 2.4G WiFi 密码。
长按设备上的按钮（或按照说明书操作）直到指示灯进入快闪模式。
小程序将自动发现并配置网络。配置成功后，设备会显示在列表中。
4. 核心接口对接（实现控制与数据上传）
芯步的 API 采用统一的签名认证机制。所有请求均为 POST 请求，数据格式为 JSON。
4.1 签名计算规则
在调用任何接口前，必须在 URL 参数中携带 sign（签名）和 ts（时间戳）以验证身份。
ts：当前 Unix 时间戳（秒）。sign：md5( md5(AppSecret) + ts )
公式解析假设你的 AppSecret 是 abc123，当前时间戳是 1609459200
先计算
md5(AppSecret)-> 得到stringA。拼接
stringA + ts-> 得到stringB。计算
md5(stringB)-> 最终的sign。
4.2 控制设备（下发命令）
通过调用 /device/control 接口，向 AC2-10A 发送开关指令。
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法：POST
Header
Content-Type: application/jsonBody 参数
| 参数 | 类型 | 描述 |
|---|---|---|
device | String | 设备的唯一ID（可在控制台查看） |
order | JSON Object | 控制指令，具体格式见下表 |
AC2-10A 支持的 order 格式
| 功能 | order 示例 | 说明 |
|---|---|---|
| 单路开启 | {"power":"1"} | 接通电路，设备通电 |
| 单路关闭 | {"power":"0"} | 断开电路，设备断电 |
| 先通后断 (脉冲) | {"point":{"relay":[1],"interval":1000}} | 立即接通，1秒后断开（马达控制常用） |
| 先断后通 (复位) | {"reset":{"relay":[1],"interval":2000}} | 立即断开，2秒后接通 |
*注：虽然官网部分示例使用 power1，但对于单路通断器 AC2-10A，通常使用 power 字段即可；若控制无效，请参考您设备详情页的具体参数。*
4.3 接收设备状态（消息推送）
为了实现“数据上传”，需要利用平台的状态回调机制。当设备状态发生变化时（例如：物理按键按下、远程控制成功、或定时任务执行），平台会主动向你的服务器推送消息。
配置回调 URL在控制台设置你的服务器接收地址（例如 http://yourdomain.com/api/device/callback）。
接收推送的示例数据当设备断开电路时，你的服务器将收到如下 JSON 格式的 POST 请求：
开发任务：你需要提供一个公网可访问的接口，解析该 JSON，并将状态存入本地数据库，实现前端页面实时展示。
5. 进阶功能与解决方案
5.1 定时任务与自动化
无需在服务器端维护复杂的定时队列。AC2-10A 支持在指令中直接包含延时动作。
场景：控制热水器在1小时后自动关闭。
指令
{"reset":{"interval":3600000}}(单位：毫秒，即1小时)。
5.2 私有化部署（局域网控制）
对于对数据安全要求比较高的场景，AC2-10A 支持 局域网直连 和 私有化部署。设备连接 WiFi 后，如果检测到与云平台握手超时，会自动尝试连接局域网内的自建服务器。该特性适用于纯内网环境的工业控制。
6. 常见问题排查
设备离线
检查 WiFi 是否为 2.4G，设备不支持 5G WiFi。
查看设备是否通电且指示灯状态正常。
签名错误 (Sign Error)
检查
ts是否为当前秒级时间戳，服务器会拒绝时间差过大的请求。核对
md5加密的拼接顺序（先加密AppSecret，再拼接ts，再整体加密）。
命令执行成功但无反馈
检查消息推送 URL 是否公网可达（不能用 localhost），且服务器日志中是否有接收记录。
7. 总结
通过上述步骤，您可以在 30 分钟内完成 AC2-10A 的接入：
配网：使用小程序将设备连上 WiFi。
调用：通过
AppId+ 动态签名算法，调用control接口发送JSON命令。联动：设置回调接口，实时捕获设备状态变化。
这种方案完全解耦了硬件逻辑，让开发者可以用标准的 Web 技术栈快速构建属于自己业务的智能用电管理系统。