芯步的智能断路器开放标准的HTTP API接口，签名认证后通过简单的JSON命令即可完成通断控制和状态读取。下面从接口鉴权、命令下发、状态反馈到工程落地，给出完整的技术方案。

1. 解决方案概览

本方案的目标是指导开发者如何使用芯步提供的开放HTTP接口，对智能断路器|30A 进行快速的二次开发。通过调用标准的API，您可以将断路器的状态（开/关）实时集成到您的自有系统（如智慧楼宇中控、能耗管理平台、自助售货机后台等）中。

核心优势：

• 轻量级接入：设备直连WiFi/4G，无需网关，标准HTTP协议，任何编程语言均可对接。

• 实时反馈：毫秒级命令响应（80-120ms），支持设备状态主动上报。

• 高可靠性：支持私有化部署和局域网纯环境运行，保障数据安全。

2. 对接前的准备

在开始编码之前，请完成以下基础配置（依据芯步标准流程）：

1. 硬件上电与配网

   • 按照产品手册完成30A断路器的导轨安装与接线。

   • 使用“芯步”微信小程序或PC控制台，将设备连接至现场2.4G WiFi网络。如果是4G版本，则无需此步骤。

2. 获取关键凭证

   • 登录[芯步控制台]，创建或进入您的“工作台”。

   • 在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。

   • 在“设备列表”中获取目标 Device ID（设备唯一ID）。

3. 接口鉴权与签名机制

芯步的API采用动态签名验证，所有控制请求均需携带签名（sign）和时间戳（ts）。签名算法逻辑如下，后端需按此规则生成URL。

签名生成规则（伪代码逻辑）：

1. 将 AppSecret 进行 MD5 加密，得到 secret_md5。
2. 将 secret_md5 与当前 Unix 时间戳（秒）拼接，得到 new_str。
3. 将 new_str 再次进行 MD5 加密，得到最终的 sign。

注：请求URL结构为 https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。

4. 核心功能实现：线路状态反馈与控制

针对30A断路器，主要涉及“线路控制”与“状态获取”两个维度。

4.1 远程控制线路通断

您可以通过向指定接口POST JSON数据，实现对断路器输出端的闭合（通电）与断开（断电）。

• 控制线路接通（通电）

  • 命令内容{"power":1} （其中 1 代表接通）

  • 场景示例：下发此命令后，30A断路器闭合，后端设备（如空调、电机）开始供电。

• 控制线路断开（断电）

  • 命令内容{"power":0} （其中 0 代表断开）

  • 场景示例：紧急情况下远程拉闸断电，保障安全。

4.2 获取实时状态反馈

您的系统需随时知晓断路器当前的状态，芯步提供了“主动查询”与“被动接收”两种模式：

• 模式一：主动查询（拉取）

  • 方案：调用设备状态查询接口（具体路径参考各版本产品手册）。

  • 用途：用于系统初始化同步，或定时轮询巡检当前是“通”还是“断”。

• 模式二：状态上报（推送）

  • 机制：当断路器状态发生变化时（例如本地手动按下按钮、或远程执行了命令），平台会实时向您配置的服务器地址推送状态变化数据。

  • 数据内容：推送的JSON中包含 power 属性的最新值。

  • 优势：真正的实时反馈，无需轮询，延迟极低。

4.3 高级控制指令

除了简单的开关，30A断路器还支持复杂的定时控制，此操作由设备硬件底层执行，不依赖您的云端服务器：

• 点动/复位控制

  • 先通后断 (Point)：立即接通线路，维持一段时间后自动断开。命令示例：{"point":1000} （接通1秒后断开）。

  • 先断后通 (Reset)：立即断开线路，维持一段时间后自动恢复接通。命令示例：{"reset":1000} （断开1秒后恢复）。

5. 代码接入示例

以下通过 curl 命令演示如何通过HTTP请求控制一台30A断路器开启。

假设参数：

• AppID: abc123

• Device ID: 820720

• AppSecret: your_secret_key

Step 1: 生成签名 (概念性步骤)假设当前时间戳 ts 为 1715222400，计算出 sign 值。

Step 2: 发送命令

返回预期：正常情况下，设备将在120ms内执行动作，并返回 {"code":0,"msg":"success"} 等类似成功标识。

6. 私有化部署与局域网对接

如果您处于纯内网环境或对公网依赖有顾虑，本产品支持完整的私有化方案。

根据芯步的文档，HTTP接口支持局域网直接访问机制。这意味着您的MES系统或楼宇自控系统可以不经过云端，直接在局域网内通过设备IP进行控制，保证数据不出厂，安全性达等保三级标准。

7. 总结和需要注意的点

1. 负载安全：30A断路器最大支持阻性负载6000W，感性负载1000W。若用于电机或LED灯，请确保功率不超过感性负载限制，以免损坏设备。

2. 网络稳定性：WiFi版本需确保现场2.4G信号覆盖良好，配置多组WiFi以增强漫游能力。若环境苛刻，推荐选用4G版本。

3. 简易对接：整个对接过程核心仅需关注 sign 签名算法和 order 命令结构，最快10分钟即可完成原型开发。