芯步60A断路器开放HTTP接口，支持签名鉴权和二次开发。以下方案涵盖接口接入、签名算法和典型联动逻辑的实现方法。关于私有化部署和消息订阅的详细配置，可在开发阶段参考平台文档。
1. 概述
60A远程控制数显断路器是芯步推出的一款大功率智能开关设备，适用于工厂、机房、充电桩等场景。该设备除了具备传统断路器的过载保护功能外，还提供实时的电压、电流、功率读数以及远程通断控制能力。
本方案的目标是指导开发者如何利用该设备开放的 HTTP API，绕过厂商自带 App 的固定逻辑，结合自身业务需求（如环境传感器、计时计费系统），搭建高灵活度的自定义联动控制系统。
2. 接口与鉴权机制解析
在开始编码前，需要理解芯步开放接口的核心交互流程。该平台采用无网关直连架构，设备通过 WiFi 直接与云端通信，开发者通过调用云端 API 实现控制。
2.1 核心请求地址
所有二次开发均围绕以下 API 端点进行：POST https://api.thingboot.com/{AppID}/device/control/
2.2 鉴权参数 (Sign 算法)
为了防止接口被恶意调用，每次请求需携带签名。签名的生成逻辑如下，在二次开发集成时需在后端实现
将您的
AppSecret进行 MD5 加密，得到encoded_secret。将
encoded_secret与当前 Unix 时间戳ts拼接（直接拼接字符串）。将拼接后的字符串再次进行 MD5 加密，得到最终的
sign。
公式Sign = MD5( MD5(AppSecret) + ts )
2.3 私有化部署说明
若项目对数据安全要求比较高（如军工或金融核心机房），芯步支持私有化部署。在此模式下，API 地址将替换为您的内网服务器地址，所有流量不外网传输。
3. 设备核心指令集
为了实现自定义联动，需熟悉断路器可接受的 JSON 命令格式。该设备支持单路控制和高级时序控制。
3.1 基本通断控制
| 动作 | 命令 JSON | 说明 |
|---|---|---|
| 开启输出 | {"power": "1"} | 闭合断路器，线路通电 |
| 关闭输出 | {"power": "0"} | 断开断路器，线路断电 |
| 读取数据 | 设备会上报 | 无法直接拉取，需通过消息接收机制获取实时电压电流值 |
3.2 自定义联动的高级指令
在自定义逻辑中，仅用“开”和“关”是不够的。该接口支持以下高级模式，这对于保护压缩机、电机等设备至关重要：
先通后断 (Point)：适用于控制电机点动。
{"point":{"interval":1000}}-> 立即通电，1000毫秒后自动断电。
先断后通 (Reset)：适用于逻辑复位。
{"reset":{"interval":2000}}-> 立即断电，保持2秒后自动恢复通电。
4. 自定义联动逻辑的实现架构
为了根据断路器读数或其他传感器触发动作，不能仅仅依赖定时任务，而需要构建一个 “监听-判断-执行” 的闭环系统。
4.1 方案一：服务器轮询与联动脚本 (推荐)
这是实现稳定自定义逻辑最通用的方案。
架构流程：
数据接收：配置服务器公网接口，芯步云平台会在设备数据变化时主动推送（HTTP Push）电压、电流和功率值过来。
逻辑判断：服务端脚本接收到数据后，执行自定义代码。例如：
if (current > 55A) then action。指令下发：当判断条件达成，服务端调用第 3 节中的 API，向该断路器下发
{"power":"0"}指令。
联动逻辑代码示例 (伪代码逻辑)：
4.2 方案二：基于定时任务的自适应电价策略
利用接口可以开发“电流限幅”或“定时控制”逻辑。
场景：结合峰谷电价，在电价高峰期限制大功率设备使用阈值。实现：编写一个定时脚本（Cron Job），在不同的时间段，如果检测到电流超过指定阈值（如 30A），则自动执行断电，直到低谷期再允许合闸。
5. 环境搭建与快速调试
在正式开始写代码前，利用芯步提供的“调试模式”快速验证接口连通性。
步骤 1：获取凭证登录芯步控制台，获取 AppID。在开发设置中，可暂时开启 “调试模式” 。开启后系统暂时不校验 sign 和 ts，方便先用 Postman 测试命令格式。
步骤 2：测试单次控制（以命令行 Curl 为例）
注：若未开调试模式，需在 URL 后拼接 ?sign=xxx&ts=xxx。
步骤 3：处理上行数据设备状态不会凭空而来。你需要有一个公网地址或使用 WebSocket 接收云平台推送的设备实时数据。只有当你能获取到实时的电流、电压数据（如 58.3A），才能写逻辑判断是否“过载跳闸”。
6. 总结
通过芯步 60A 断路器的开放接口进行二次开发，核心在于利用 control 接口结合 消息推送 机制。开发者不应局限于简单的远程开关，而应利用 point、reset 等高级指令保护负载设备，并结合业务数据库实现用电数字化管理。
由于不同型号（如单相/三相）的寄存器地址略有差异，开发时以设备详情页的《产品手册》命令列表为最终依据。