怎么对接25A过流保护智能断路器以实现远程通断控制_解决方案

CATALOG

25A过流保护智能断路器在工业场景中承载着6000W大功率设备的通断控制，对接时需要重点关注接口鉴权机制和命令格式的准确性。以下方案基于芯步的开放HTTP接口，提供从签名计算到设备控制的完整对接流程。

1. 产品概述与接口能力

芯步25A过流保护智能断路器是一款支持WiFi通信的大功率通断控制设备，最大负载能力达25A/6000W，适用于工业设备、充电桩、大功率电器等场景。该设备基于芯步开放平台，提供标准HTTP API接口，支持开发者通过任何支持HTTP协议的编程语言（Java、Python、Go、PHP、JavaScript等）实现远程控制和状态管理。

核心开放能力：

远程单路通断控制（闭合/断开）
支持批量设备控制
支持定时任务与联动操作
设备状态实时查询
私有化部署支持（可选自建MQTT/HTTP服务器）

2. 对接前置准备

2.1 平台账号与凭证获取

在进行API对接前，需要完成以下准备工作：

注册芯步账号：访问芯步官网（）完成注册
创建工作台：登录后进入控制台，创建新的工作台实例
获取AppID和AppSecret：在控制台的“开发设置”中获取应用的唯一标识（AppID）和密钥（AppSecret），这是后续API鉴权的核心凭证
添加设备并获取Device ID：将25A智能断路器配网绑定后，在控制台设备列表中找到该设备，复制其唯一的Device ID（设备ID）

2.2 网络环境确认

确保智能断路器已连接至2.4GHzWiFi网络（不支持5G频段）
设备所在网络需能够正常访问芯步云端API服务器（）
若采用私有化部署方案，需准备本地MQTT/HTTP服务器地址

3. API鉴权机制（签名算法）

芯步开放接口采用双重MD5签名机制保障请求安全性，每次API调用均需携带动态生成的签名（sign）和时间戳（ts）。

签名生成步骤：

将AppSecret进行第一次MD5加密，得到字符串secret_md5 = md5(AppSecret)
将上述结果与当前Unix时间戳（秒级）拼接：secret_md5_ts = secret_md5 + ts
对拼接后的字符串进行第二次MD5加密：sign = md5(secret_md5_ts)

示例代码（Bash）：

请求URL格式：

https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

注：{AppID}为应用ID，直接拼接在路径中，非查询参数

4. 远程通断控制实现

4.1 核心接口：设备控制

接口地址：POST /{AppID}/device/control/

请求参数：

参数名	类型	必填	说明
device	string	是	设备唯一ID，支持多个设备用英文逗号分隔
order	json string	是	控制命令，JSON格式字符串

25A智能断路器的order命令格式：

该设备为单路控制器，使用power1字段控制通断：

操作	order参数值	说明
闭合/通电	`{"power1":1}`	接通电路，设备开始供电
断开/断电	`{"power1":0}`	断开电路，设备停止供电

4.2 多编程语言对接示例

Python示例

Java示例

import okhttp3.*;
import java.security.MessageDigest;
import java.time.Instant;

public class BreakerController {
    public static void main(String[] args) throws Exception {
        String appId = "your_app_id";
        String appSecret = "your_app_secret";
        String deviceId = "your_device_id";
        
        // 生成签名
        long ts = Instant.now().getEpochSecond();
        String secretMd5 = md5(appSecret);
        String sign = md5(secretMd5 + ts);
        
        // 构建请求
        OkHttpClient client = new OkHttpClient();
        String url = "https://api.thingboot.com/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        JSONObject payload = new JSONObject();
        payload.put("device", deviceId);
        payload.put("order", "{\"power1\":1}");  // 1-通电，0-断电
        
        Request request = new Request.Builder()
            .url(url)
            .post(RequestBody.create(payload.toString(), MediaType.parse("application/json")))
            .build();
        
        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
    
    private static String md5(String input) {
        // MD5加密实现
    }
}

JavaScript（Node.js）示例

4.3 批量设备控制

若需同时控制多个25A断路器，可在device参数中用逗号分隔多个设备ID，order命令将同时下发至所有指定设备：

4.4 高级控制功能

芯步接口还支持以下扩展命令，适用于需要脉冲控制或时序控制的场景

功能	order命令	说明
先通后断（点动）	`{"point1":时间间隔}`	先闭合线路，间隔指定毫秒后断开
先断后通（复位）	`{"reset1":时间间隔}`	先断开线路，间隔指定毫秒后闭合
状态保持	`{"power1":1,"hold":1}`	保持通电状态，断电重启后恢复

点动示例（通电1秒后自动断电）：

5. 设备状态查询

5.1 查询单个设备状态

通过设备控制接口也可获取设备当前状态（响应报文中包含设备通断状态）。配合平台的状态查询接口使用（详见芯步API文档）。

5.2 状态响应解析

成功下发命令后，API会返回JSON格式响应，包含：

code：状态码（200表示成功）
message：返回信息
data：设备执行结果详情

6. 私有化部署方案（可选）

对于数据安全要求较高的内网环境，芯步25A智能断路器支持私有化部署

自建MQTT服务器：设备可直接连接客户自建的MQTT Broker（如EMQX、Mosquitto），完全脱离公有云
本地HTTP API：在局域网内部署HTTP接口服务，实现纯内网控制
自定义TCP协议：支持基于TCP Socket的底层通讯，适用于嵌入式系统对接

私有化部署时，需在设备配网阶段配置自定义服务器地址，具体配置方式参见产品手册。

7. 注意事项与最佳实践

7.1 签名时效性

时间戳ts使用Unix秒级时间戳，服务器会校验时间戳有效性（通常允许5分钟误差）
每次请求前实时生成签名，避免复用

7.2 错误处理

常见错误码及处理：

HTTP状态码	错误原因	解决方案
401	签名错误或时间戳无效	检查AppSecret和时间戳生成逻辑
404	AppID或设备ID不存在	确认AppID和设备ID是否正确
429	请求频率过高	降低请求频率（间隔≥1秒）
503	设备离线	检查设备网络连接状态

7.3 设备离线处理

设备离线时API会返回错误，在业务逻辑中加入离线重试机制
可利用平台提供的设备状态回调功能，实时感知设备在线/离线变化

7.4 安全

AppSecret应存储在服务端，严禁在前端代码中暴露
生产环境增加IP白名单限制
定期轮换AppSecret以提高安全性

8. 总结

通过芯步开放的HTTP API接口，开发者可以快速实现对25A过流保护智能断路器的远程通断控制。整个对接过程核心包括：获取凭证 → 计算签名 → 构建请求 → 下发命令四个步骤。该方案具有以下优势：

开发门槛低：标准HTTP协议，支持任意编程语言
响应速度快：云端直达设备，平均延时＜1秒
扩展性强：支持批量控制、定时任务、私有化部署
安全可靠：双重MD5签名+HTTPS传输

如需了解更多接口细节（如设备列表查询、事件回调配置等），可登录芯步控制台查看完整的API文档和设备手册。