芯步的AC4-20A智能通断器支持HTTP API远程控制，功率达4400W，适合各类商业负载场景。以下方案涵盖设备配网、接口签名、单路控制命令的实现逻辑及典型应用示例。

1. 产品选型与核心参数

在开始对接前，我们先明确本次选用的硬件——芯步 智能通断器 AC4-20A。

• 产品名称：智能通断器 AC4-20A

• 核心功能：单路交流负载通断控制

• 额定参数：支持交流 20A 电流，总额定功率高达 4400W。这意味着它可以轻松覆盖绝大多数商业场景下的单路负载，如大型照明灯具、自动售货机、工业排风扇、水泵等。

• 控制接口：支持 HTTP API 远程控制，同时预留了物理按钮接口，支持自定义或屏蔽本地操作 。

• 通信方式：Wi-Fi (2.4GHz)，支持局域网和公网控制。

2. API 对接设计

整个对接方案采用标准的 物联网云平台架构。你的业务系统（如 SaaS 后台、小程序、App）不直接与硬件建立长连接，而是通过调用芯步开放平台的 HTTP 接口来实现控制。

• 架构流程图解

  1. 准备阶段：开发者在芯步控制台获取 API 密钥（AppID， AppSecret）。

  2. 设备入网：AC4-20A 设备上电，通过配网工具连接现场 2.4G Wi-Fi。设备自动注册到云平台。

  3. 业务调用：你的业务服务器向芯步 API 发起 HTTP POST 请求，携带签名、设备 ID 和控制指令（如 {"power":1}）。

  4. 指令下发：平台验证签名后，通过长连接将指令推送到目标设备。

  5. 状态反馈：设备执行指令（继电器吸合/断开），并返回执行结果。

3. 详细对接步骤

3.1 前期准备：获取密钥与设备ID

在开始编码前，需准备好以下凭证：

1. 注册与登录：访问芯步官网注册账号 。

2. 获取 AppID 和 AppSecret：登录后，进入“物联网控制台” -> “开发设置”。这里的 AppSecret 非常重要，用于生成签名 。

3. 获取设备 ID (Device ID)

   • 设备成功配网后，会在控制台的“设备列表”中显示。

   • 记录下该设备的唯一标识 ID（通常是一串数字），例如 1234567890。

3.2 设备配网（现场部署）

拿到硬件后，需将其接入网络 。

• 推荐方式：使用“芯步”微信小程序。

• 步骤

  1. 手机连接现场 2.4G Wi-Fi。

  2. 小程序登录你的账号。

  3. 点击“添加设备” -> “网络配置”，输入 Wi-Fi 密码。

  4. 长按设备上的按钮（或根据说明书操作），直到指示灯进入快闪模式（配网状态）。

  5. 小程序自动发现设备并完成配网。

3.3 API 签名机制（核心安全逻辑）

为防止接口被恶意调用，API 调用需要携带签名（sign）。签名算法如下

Sign = md5( md5(AppSecret) + ts )

• AppSecret：你的开发者密钥。

• ts：Unix 时间戳（秒），用于防止请求重放攻击。

生成步骤示例（伪代码）

3.4 实现单路负载控制（HTTP API）

这是最关键的一步。你需要向指定的 URL 发起 POST 请求。

• 请求地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}注意：{AppID} 也需要替换成你的应用 ID。

• 请求头 (Header)Content-Type: application/json

• 请求体 (Body) - 控制开启假设我们需要开启 ID 为 1234567890 的设备。

• 请求体 (Body) - 控制关闭

• 命令字段详解根据 AC4-20A 的指令集，power 是控制继电器通断的核心属性 。

  • “power”: 1：代表接通负载（开启电器）。

  • “power”: 0：代表断开负载（关闭电器）。

3.5 代码示例（cURL 和 Python）

1. cURL 命令示例

2. Python 示例

4. 高级功能与集成

除了基本的开关，该接口还支持一些高级指令，以增强系统的健壮性。

4.1 脉冲模式（先断后通 / 先通后断）

在某些场景下（如控制门锁或电机点动），你需要设备接通 2 秒后自动断开。AC4-20A 支持通过 reset 命令实现延时自复位 。

• 场景：控制自动喷淋，打开 5 秒后自动关闭。

• 下发指令

4.2 并发控制（标签控制）

如果你需要同时控制成百上千个 20A 开关（例如在大型展会中统一控制所有展位电源），使用 标签控制接口。

• 原理：在芯步控制台将多个设备绑定在同一个标签（Tag）下。

• 接口POST /{AppID}/tag/control/

• 优势：一条指令即可操控一组设备，延迟低，效率高。

4.3 私有化部署

如果对数据安全要求比较高（如金融或军事设施周边），芯步 AC4-20A 也支持 局域网 和 私有化 部署。设备可直接通过 HTTP 协议直连你的本地服务器，不经过外网 。

5. 总结

通过“芯步”的 AC4-20A 智能开关及其开放接口，实现单路交流负载控制在技术上非常直接。我们只需遵循 “获取凭证 -> 设备配网 -> 计算签名 -> 下发 Power 命令” 这一链路，即可在 1 小时内完成从硬件上电到第一个远程开关指令的成功执行。

对于 20A（4400W）的大功率应用场景，请一定要注意现场走线的线径（不低于 2.5mm²）和接线牢固度，以确保物理安全与软件逻辑的完美配合。