芯步50A大功率计量断路器的开放HTTP接口，为二次开发提供了很大的灵活性。结合官方技术文档，我从接口对接、数据获取到规则引擎设计，整理了这套自定义联动方案，希望能帮助你实现各类业务场景。

1. 产品与接口概述

1.1 设备核心能力

芯步智能大功率断路器50A（型号：UNI-DLQ-M-50A）是一款支持WiFi 2.4G直连的工业级智能开关设备。相比普通断路器，其核心优势在于：

• 大功率承载：支持50A额定电流，适用于空调、充电桩、大功率电机等重负载场景。

• 计量功能：实时上报电压、电流、功率、电量等数据（计量数显版特有）。

• 开放接口：提供全开放的HTTP API接口，支持任何能发起HTTP请求的编程语言或平台（如Python、Java、Node-RED、小程序后端等）。

1.2 接口特点

• 协议简单：基于HTTP/HTTPS POST请求，携带签名认证。

• 支持私有化：设备支持私有化部署和局域网自建消息服务器，数据可不经过公网。

• 实时性：配合回调/推送机制，可实时获取设备状态变化，无需频繁轮询。

2. 二次开发环境准备

在开始编码实现自定义联动之前，需要完成以下基础对接：

2.1 获取凭证与设备ID

1. 登录芯步官方控制台。

2. 注册应用，获取 AppID 和 API Key（用于生成签名）。

3. 在控制台添加设备，获取唯一的 Device ID（设备ID）。

2.2 接口鉴权机制

所有API请求需包含签名参数，具体规则如下（根据官方文档通用逻辑整理）：

• URL结构POST https://api.thingboot.com/{AppID}/device/control?sign={sign}&ts={timestamp}

• 签名生成：通常为将参数排序后拼接Key进行MD5加密。

• Header：需携带 Content-Type: application/json。

2.3 数据获取方式

为了实现“自定义联动”，必须获取设备的实时计量数据。采用 消息订阅/推送 模式而非轮询：

• 自建消息服务器：在控制台配置回调URL（Webhook）。当设备数据变化时，平台会主动POST数据到你的服务器。

• 数据解析：收到的JSON数据中通常包含 current（电流）、power（功率）、energy（电量）等字段。

3. 自定义联动逻辑的开发实现

本方案的核心在于：读取计量数据 -> 逻辑判断 -> 调用控制接口。

3.1 控制接口调用示例

你需要编写函数向设备下发命令。根据官方文档，控制指令通过 order 参数传递，格式为JSON字符串。

需求场景：关断断路器。

• 接口地址POST /YourAppID/device/control?sign=xxx&ts=1726213456

• POST Body (JSON)

• 参数解释order 值为 {“power”: “0”} 代表断开；{“power”: “1”} 代表闭合。

3.2 核心开发：规则引擎设计

为了实现“自定义联动”，你需要设计一个轻量级的规则引擎。以下以“过载保护联动”和“峰谷电价联动”为例说明逻辑代码的设计思路。

第一种场景：动态过载保护（非固定阈值）

虽然断路器本身有过载保护，但你可以通过软件实现更灵活的“软保护”。例如：当电流超过45A且持续时间超过5秒，则自动断电，并延迟5分钟自动重试。

伪代码实现逻辑

第二种场景：基于电量的自动通断（联动充电桩/空调）

利用计量功能，实现“充满自停”或“温度到达自动断电”。需求：监测到功率低于50W（设备待机/充满）持续2分钟，自动切断电源以节能。

伪代码实现逻辑

3.3 高级联动：多设备协同

你可以利用HTTP接口的 批量控制 功能，实现设备间的联动。

场景：远程监控机房里，一旦50A断路器检测到主设备电流异常（如宕机导致电流骤降），立即重启下级设备。

• Step 1: 服务器接收计量数据，判定电流 < 1A（设备宕机）。

• Step 2: 发送组合命令给同一台或多台设备：

说明：这里的 point 命令实现了“先断后通”，间隔5000毫秒，实现了自动重启逻辑，无需人工干预。

4. 架构部署

为了保障业务逻辑的稳定运行，采用以下架构：

1. 后端服务

   • 使用Node.js、Java Spring Boot或Python FastAPI搭建轻量级服务。

   • 核心模块：数据接收路由（Webhook）、逻辑判断模块、命令下发模块。

2. 数据存储

   • Redis：必选。用于存储设备上一次的状态（如过载标记、低功率计时），利用其过期特性实现“冷却时间”或“触发延时”。

   • MySQL（可选）：存储历史操作记录、联动日志，用于审计。

3. 网络拓扑

   • 由于设备支持WiFi直连且支持局域网私有化，为了保证低延迟和高安全性，服务器与设备部署在同一局域网内，通讯走内网IP，完全脱离外网。

5. 总结与扩展

通过上述方案，你可以完全解放50A大功率断路器的潜力，不再局限于简单的远程开关，而是打造成真正的智能配电单元。

• 协议标准化：利用HTTP的通用性，任何编程语言都可以轻松集成。

• 逻辑自定义：基于电流、功率数据的软逻辑判断，可以实现预测性维护、节能优化等高级功能。

• 快速扩展：如果你想将此能力接入微信小程序，只需将后端API封装成云函数即可。

通过二次开发，芯步的这一硬件可以无缝融入你的企业ERP、智能工厂MES系统或家庭自动化中枢。

注：以上技术实现逻辑基于芯步公开的HTTP API通用规范撰写，具体字段名（如计量数据的Key值）以你在控制台收到的实际数据为准，开发时请参考最新的设备技术手册。