35A智能断路器的开放接口采用标准HTTP协议,这意味着你可以用任何编程语言直接调用,无需额外网关。批量控制的核心在于两条:一是利用签名机制保障接口调用的安全性,二是通过设备ID数组配合批量命令参数实现一键操作。下面从对接流程到落地部署一一展开。
1. 背景与概述
随着智慧园区、智能楼宇及无人值守站点的普及,传统的配电管理方式已无法满足快速响应和集中运维的需求。传统的空气开关需要人工现场操作,效率低且存在安全隐患。
本方案基于芯步 35A 智能断路器(型号:UNI-DLQ-35A)及其开放 API,旨在解决在 多设备、多区域 场景下的远程集中控制难题。通过该方案,运维人员或业务系统可通过互联网/局域网,对分布在不同位置的 35A 断路器进行 批量分闸、合闸、定时任务及状态监测,实现对大功率电器(如空调、照明总线路、大型设备)的智能化管控。
2. 核心技术原理
35A 智能断路器不同于普通的智能插座,它直接串联在 220V 市电入户或大功率设备前端,支持最高 7000W 阻性负载。本方案的核心对接逻辑如下:
通信方式:设备内置 2.4G WiFi 模块,无需额外网关,上电后即可联网。
接口协议:全系开放 HTTP API,请求方式为
POST,数据格式为JSON。网络穿透:既支持使用芯步官方云平台进行远程控制,也支持私有化部署,将 API 接口部署在本地服务器,确保数据不出园区。
3. API 对接流程详解
要实现“批量控制”,首先需要完成单个设备的对接认证。以下为标准的对接时序与执行步骤。
3.1 前期准备
设备激活:为 35A 断路器接通电源,通过“芯步”App 或小程序为其配置 WiFi 网络。
获取凭证:登录芯步控制台,获取专属的
AppID和AppSecret。这是所有 API 请求的“身份证”。
3.2 签名机制
为了防止接口被恶意篡改,所有开放接口均需携带动态签名。芯步采用双重 MD5 加密策略:
公式
Sign = MD5 ( MD5 (AppSecret) + ts )参数说明
AppSecret:开发者密码。ts:当前 Unix 时间戳(秒级)。
作用:每次请求的签名都不同,且具有时效性,有效防止重放攻击。
3.3 核心接口调用
您可以使用任何支持 HTTP 请求的语言(如 Python, Java, Node.js, PHP)或工具进行对接。
请求地址POST https://api.thingboot.com/{AppID}/device/control/sign={sign}&ts={ts}
请求头 (Headers)
Content-Type: application/json
Body 参数示例
这是单设备控制的底层逻辑。假设我们需要控制设备 ID 为 DEV001 的断路器闭合:
注:order 为 JSON 字符串格式。"power":"1" 代表闭合(通电),"power":"0" 代表断开(断电)。
4. 批量控制方案实现
这是本方案的核心。针对“批量控制”,我们有三种实现策略,推荐根据实际场景选择第二种或第三种。
4.1 方案一:并发请求(适合设备数量少,<10台)
如果仅需控制几台设备,后端可直接循环调用单设备接口。
实现的方式是:使用多线程或异步 IO 同时向多个
device发送power指令。评价:简单直接,但当设备数量多时,效率较低,容易触发网络拥塞。
4.2 方案二:批量指令聚合(推荐)
芯步的 HTTP 接口支持 单次请求控制多个设备,这是实现高效批量控制的官方推荐方式。
实现代码逻辑示例(伪代码/Python 风格)
参数深度解析
device:支持字符串拼接,例如"ID1,ID2,ID3"。网关收到此请求后,会分发命令给内部队列。order如果只想批量开启,将
power改为"1"。如果只想控制特定回路(35A通常只有1路大功率回路,但如果是4路控制器则可指定),修改
relay数组。此方式极大的节省了 HTTP 连接开销,秒级内可完成上百台设备的控制。
4.3 方案三:场景联动与定时任务(全自动)
不需要编写代码,通过在控制台设置 “联动规则” 实现批量控制。
场景应用
上班模式:每天早上 8:30,系统自动批量闭合(合闸)所有办公区断路器。
下班模式:晚上 20:00,系统自动批量断开(拉闸)所有非核心设备断路器。
紧急联动:当烟感传感器触发时,批量断开所有 35A 断路器,自动切断电源防火。
5. 高级特性和需要注意的点
5.1 私有化部署(内网穿透替代方案)
对于对数据安全要求比较高的工厂或政府单位:
芯步 35A 断路器支持 局域网发现与控制。
实施:搭建本地服务器,部署 API 中转服务。断路器和服务器在同一局域网(或 VLAN)下,数据交互不经过外网,延迟可降低至毫秒级。
5.2 时序控制
某些精密设备不能瞬间直接断电,需配合“先通后断”功能。
命令示例
{"point":{"relay":[1],"interval":1000}}释义:执行“点动”模式,先合闸通电,1秒(1000毫秒)后自动分闸断电。在批量控制场景中,可用于设备重启测试。
5.3 负载安全
功率限制:虽然标称 35A,但如果是感性负载(如电机、电梯、空调压缩机),最大功率控制在 1100W 以内;阻性负载(如白炽灯、电暖气)可达 7000W。批量控制时需注意总线路的承载,避免同时合闸产生浪涌电流。
6. 实施落地步骤
安装部署:将 35A 断路器安装于标准导轨(35mm),接入 WiFi,确保信号强度。
平台注册:在芯步官网注册企业账号,创建设备实例。
接口测试:使用 Postman 或 CURL 测试签名算法与单设备通断。
业务集成:将上述的 【方案二:批量指令聚合】 集成到现有的 ERP、OA 或园区管理系统中。
安全验证:配置 IP 白名单,加强接口调用安全性。
总结
通过对接芯步 35A 智能断路器的开放 API,开发者可以利用 “设备ID列表 + 批量命令参数” 的简单组合,实现从“人工拉闸”到“一键控制成百上千台设备”的跨越。该方案不仅降低了运维成本,还通过私有化部署保障了核心数据安全,是工业及商业物联网改造的高效路径。