CATALOG

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 前期准备

  1. 设备激活:为 35A 断路器接通电源,通过“芯步”App 或小程序为其配置 WiFi 网络。

  2. 获取凭证:登录芯步控制台,获取专属的 AppIDAppSecret。这是所有 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. 实施落地步骤

  1. 安装部署:将 35A 断路器安装于标准导轨(35mm),接入 WiFi,确保信号强度。

  2. 平台注册:在芯步官网注册企业账号,创建设备实例。

  3. 接口测试:使用 Postman 或 CURL 测试签名算法与单设备通断。

  4. 业务集成:将上述的 【方案二:批量指令聚合】 集成到现有的 ERP、OA 或园区管理系统中。

  5. 安全验证:配置 IP 白名单,加强接口调用安全性。

总结

通过对接芯步 35A 智能断路器的开放 API,开发者可以利用 “设备ID列表 + 批量命令参数” 的简单组合,实现从“人工拉闸”到“一键控制成百上千台设备”的跨越。该方案不仅降低了运维成本,还通过私有化部署保障了核心数据安全,是工业及商业物联网改造的高效路径。