芯步的20A智能断路器（含AC4-20A通断器）通过开放HTTP API接口，支持远程状态查询与控制。以下方案涵盖设备配网、签名计算、接口调用和状态查询的完整流程。
1. 解决概述
目标： 通过调用芯步开放平台的HTTP接口，实现对20A智能断路器（如AC4-20A）的远程开关状态查询。
核心逻辑： 开发者获取AppID和AppSecret后，动态生成包含时间戳和签名的请求URL，向指定设备ID发送查询或控制指令order。设备通过WiFi接收指令并返回当前状态。
适用产品：
智能通断器 AC4-20A：单路控制，支持4400W大功率。
智能断路器20A：支持标准20A电流管理。
技术优势： 支持公网/局域网控制，接口响应快速（约80-120ms），适合集成于Web、App、小程序或SaaS平台。
2. API接口与签名机制
2.1 请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}{AppId}：应用ID，在芯步控制台获取。{sign}：接口签名，用于身份验证。{ts}：Unix时间戳（秒）。
2.2 签名生成算法
签名生成规则为双重MD5加密（即 MD5(MD5(AppSecret) + ts)），详细步骤如下：
第一重加密：对
AppSecret进行一次MD5加密，得到字符串secret_md5。字符串拼接：将
secret_md5与时间戳ts进行拼接，得到secret_md5 + ts。第二重加密：对上一步拼接后的字符串再次进行MD5加密，得到最终的
sign。
示例代码（Bash）：
注：需将 AppSecret 替换为实际凭据
2.3 请求头与数据格式
Method： POST
Content-Type： application/json
Body： JSON格式，包含
device（设备ID）和order（指令内容）。
3. 设备配网与ID获取
要实现远程控制，首先需确保断路器连接互联网并获取唯一的设备ID。
注册与登录：访问芯步官网注册账号。
配网操作
电脑端：进入“物联网控制台” -> “网络配置”，登记现场2.4G WiFi信息，并为设备配置网络。
小程序端：使用“芯步小程序”，登录同一账号，添加现场WiFi进行配网。
获取Device ID：设备成功配网后，会在控制台“设备列表”中显示，并生成一串数字ID（例如
820720），这是后续接口调用的目标标识。
4. 开关状态查询与远程控制实操
该接口通过order参数中的power字段来控制设备通断，通过响应结果获取状态。
4.1 需求指令对照表
以 AC4-20A 型号为例
| 操作指令 | order 参数值 | 说明 |
|---|---|---|
| 查询状态 | (或不传) | 通常设备响应会直接返回当前状态字段 |
| 开启 (合闸) | {"power": 1} | 闭合断路器，电路接通 |
| 关闭 (分闸) | {"power": 0} | 断开断路器，电路切断 |
| 临时通断 | {"reset": 3000} | 立即断电，3秒（3000毫秒）后自动复位通电 |
注意：如果查询状态有专门接口，参考官方API文档；若无，发送空指令或依赖控制返回的即时信息也是常见处理方式。
4.2 请求示例
假设 AppId=12345，Device=820720，要执行开启操作：
请求URL：
https://api.thingboot.com/12345/device/control/?sign=xxxxxx&ts=1704067200
请求Body：
4.3 代码接入示例 (Python)
以下是集成到您的业务系统中的核心逻辑：
代码参考自官方接口逻辑及开源社区实践
5. 本地局域网控制方案 (私有化)
若您的业务系统运行在本地服务器，且希望减少公网延迟或断网影响，AC4-20A支持局域网HTTP控制
前提：确保您的PC/服务器与智能断路器连接在同一个路由器下的同一网段。
地址：设备联网后，可在路由器管理界面或通过官方工具查找到设备的局域网IP（如
192.168.1.100）。调用：直接向
http://{设备IP}/control/发送POST请求，参数格式与公网API一致。
此方案适合MES系统、数据中心等内网环境，响应速度更快且不占用外网带宽。
6. 常见问题排查
签名错误 (sign invalid)
检查时间戳
ts是否为Unix秒级时间戳，且与服务器时间误差不宜过大（通常不超过5分钟）。确认
AppSecret来源正确，双重MD5的顺序是否为MD5(MD5(Secret)+ts)。
设备离线 (device offline)
确认设备供电正常，且WiFi信号强度足够。
智能断路器仅支持 2.4G WiFi，不支持5G频段。
控制无响应
确认
order参数格式是否为合法的JSON字符串。若功率超过4400W，设备可能触发过载保护，请检查负载。
7. 总结
通过上述方案，您可以利用芯步的标准HTTP接口，在10-30分钟内完成20A智能断路器的接入开发。核心在于正确生成动态签名，并将封装好的JSON指令发送至指定设备ID。该系统不仅支持云端公网控制，也兼容本地局域网直连，适用于智慧工厂、智能楼宇及自动化农业等多种场景。