CATALOG

60A带计量断路器在商业场景(如充电桩、基站、暖通空调)中应用广泛,其核心价值在于“通断控制+能耗计量”一体化。芯步的开放接口采用标准HTTP协议,签名机制清晰,通常10-20分钟即可完成对接。以下方案涵盖接口封装、代码实现及计量数据获取方法。

解决方案:基于芯步开放接口接入60A带计量物联网断路器实现HTTP远程通断控制

1. 背景与概述

在智能楼宇、基站远程抄表、智慧充电桩等场景中,60A大功率物联网断路器不仅需要承载高电流负载,更需要具备远程控制与电能计量功能。芯步提供的开放接口基于标准HTTP协议,允许开发者通过简单的POST请求即可实现对设备的合闸/分闸控制,并通过回调或查询机制获取电压、电流、功率等计量数据。

本方案的目标是指导开发者如何通过芯步的API接口,快速集成60A带计量物联网断路器,实现远程通断控制。

2. 准备工作与对接架构

在开始开发前,需要准备以下三项关键信息:

  • AppID 与 AppSecret:在芯步控制台的“开发设置”中获取,用于身份验证和签名生成

  • 设备ID (Device ID):60A断路器设备的唯一标识,可在控制台设备列表或设备外壳标签上找到

  • 网络环境:确保服务器或终端能访问芯步API公网域名,或根据项目需求部署私有化环境。

对接架构图(文字描述):业务系统/Server -> HTTP POST (携带Sign/TS) -> 芯步云端API -> MQTT/CoAP -> 60A物联网断路器

3. 核心步骤:实现HTTP远程通断控制

芯步的接口设计遵循无状态原则,通过双重MD5签名保障安全性。断路器作为执行设备,通常支持power(总开关)或power1(第1路)等标准指令。

3.1 签名生成规则

为了防止接口被恶意篡改,每次请求需动态生成signts(时间戳)。生成逻辑

  1. 将 AppSecret 进行一次 MD5 加密:secret_md5 = md5(AppSecret)

  2. 拼接时间戳:str_to_sign = secret_md5 + ts

  3. 再次进行 MD5 加密得到最终签名:sign = md5(str_to_sign)

3.2 接口调用与代码示例

请求地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方法POST请求头Content-Type: application/json

请求体示例假设我们需要让设备ID为 1122334455 的断路器合闸(通电) ,指令如下:

(注:如果需要分闸,将 1 改为 0 即可;如果该设备是多路计量断路器(如2路或4路),则使用 power1power2 分别控制)

cURL 调用示例(含签名计算):

3.3 特殊情况:定时或延时控制

60A断路器常用于大功率设备保护,若需实现“临时供电”场景(例如给电动车充电1小时后自动断电),可利用reset参数实现精准延时:

上述指令会接通电路,并在 3600000毫秒(即1小时) 后自动断开,无需在服务器端维护定时任务队列

4. 进阶应用:获取计量数据

60A带计量断路器除了通断控制,核心价值在于数据可视化。获取计量数据通常有两种方式:

  • 方式一:主动查询(实时性要求不高)调用 设备详情设备数据 接口,主动拉取当前的电压、电流、功率因数等数据。

  • 方式二:异步推送(推荐,实时性高)在芯步控制台配置 HTTP 推送 地址(Callback URL)。当断路器上报计量数据变化时(如功率突变),平台会主动向你的服务器推送JSON数据包。这种方式下,你的系统可以实时感知负载变化,及时发现异常用电

推送数据解析示例:

5. 注意事项与优化

  • 执行结果确认:由于网络波动,HTTP 200 状态码仅代表指令已下发至云端。为确保设备确实执行了合闸/分闸,监听设备的 状态回调 或延时1秒后调用 设备状态查询接口 确认 power 字段的返回值

  • 批量控制:若需控制机房内的多台60A断路器,device 参数支持用逗号 , 或竖线 | 拼接多个设备ID(单次不超过100台),实现一键断电等操作

  • 私有化部署:如果对数据安全要求比较高(如金融、军工配套),芯步支持将整套API私有化部署到你的局域网或专有云服务器中,此时API地址将变更为你的内网IP

6. 总结

通过芯步的开放接口接入60A带计量断路器的流程极为轻量。开发者仅需掌握 动态签名计算JSON命令结构 即可完成对接。方案实施后,你将获得对大功率线路的“遥控、遥测、遥信”能力,便于构建商业计费系统或能源管理系统。