25A智能断路器的开放接口采用标准HTTP协议,这意味着任何能联网的编程环境——Web后端、App、小程序甚至SaaS平台——都可以直接调用。以下方案从选型、硬件安装到接口对接全流程展开,你可以根据自己的业务系统语言(Java/Python/PHP等)对照实现。
1. 背景与选型
在许多商业场景(如共享自习室、自助健身房、远程控制机房)中,常常需要远程控制大功率设备。芯步推出的 25A智能断路器 专为此类场景设计,其核心优势在于:
大功率承载:额定25A电流,纯阻性负载下最大支持 5000W,满足空调、热水器、大型照明线路等需求 。
接口开放:产品开放标准的 HTTP API 接口,无论你的后端系统是 Java、Python、PHP 还是小程序环境,均可轻松集成 。
灵活联网:支持WiFi(2.4GHz)直连,无需额外网关;部分版本支持4G,适用于无宽带环境 。
本方案将指导开发者/集成商完成从硬件选型、安装配网到最终通过接口实现通断控制及状态查询的全过程。
2. 产品选型与硬性限制
在开始对接前,请请一定要确认所选型号符合物理场景需求:
| 项目 | 参数规格 | 注意事项 |
|---|---|---|
| 产品型号 | UNI-DLQ-25A 系列 | 含WiFi版、WiFi+433遥控版、4G版 |
| 额定电流 | MAX 25A | 不可超载,预留20%余量 |
| 负载功率 | 5000W (阻性) | 关键限制:若负载为电机、LED灯或节能灯(感性/容性),实际带载能力会骤降至 800W 以下,必须降额使用或加装交流接触器 |
| 工作电压 | AC 85-265V | 适用于全球标准市电 |
| 联网方式 | 2.4G WiFi 或 4G | 不支持 5G WiFi 频段 |
3. 硬件安装与配网
3.1 安装接线
采用标准 35mm 导轨式安装,直接卡入配电箱即可。接线注意事项
进线端:上端口接入市电火线(L)。
出线端:下端口接负载火线,零线(N)必须共用但需保持零线直通或通过零排连接,严禁将零线接入断路器输出端(除非设备标注为2P或带零线)。
安全:由于涉及强电,必须由持证电工操作,安装前请一定要断电。
3.2 设备配网
上电:断路器通电,此时设备进入配网模式(通常指示灯快闪)。
连接
WiFi版:使用“芯步”官方App或依据其开放协议,通过 SoftAP 配网 或 智能配网 将设备加入本地局域网。
4G版:直接插入SIM卡,设备自动联网(无需配置WiFi)。
获取标识:配网成功后,在管理后台或App中获取该设备的唯一标识——Device ID (设备ID)。这是后续API调用中的核心参数。
4. 开放接口对接开发指南
芯步的25A断路器最核心的开放能力在于 HTTP 远程控制。任何能发起HTTP请求的编程语言均可调用。
4.1 接口通用规范
协议: HTTPS / HTTP
请求方法: POST (推荐) 或 GET
数据格式: Application/JSON
鉴权机制: 接口通常需要携带
AccessToken或API Key以及Sign(签名)。
4.2 核心对接流程
开发者需要实现三个核心环节:获取指令、下发控制、状态上报。
步骤一:获取 Token / 签名在调用控制接口前,需使用在芯步平台申请的 AccessKey/SecretKey 生成签名,或获取临时令牌,放入请求头(Header)。
请求示例(概念):Header: Content-Type: application/jsonHeader: Authorization: Bearer [Your_Access_Token]
步骤二:下发控制指令向指定的API网关地址发送指令,控制断路器的“通”或“断”。
接口地址:
https://api.yoyoiot.com/ordercontrol请求体
步骤三:查询实时状态由于断路器可能被人手工按下物理按键或过载跳闸,业务系统需要同步最新状态。
接口地址:
https://api.yoyoiot.com/orderstatus响应示例
通过功率和电流数据,可实现负载监测,例如检测设备是否空载运行。
4.3 负载适应性配置
由于该断路器对 感性负载 有 800W 的限制,如果你的负载是电机类(如麻将机、排风扇),有两种解决方案:
方案A:外接接触器
让断路器的输出端接到一个220V交流接触器的线圈上,由接触器的主触点去控制大功率电机。这样断路器只承受线圈的小电流(瓦级),彻底解决功率限制问题。
方案B:软件限制
在业务逻辑中设置软锁。例如,通过API获取设备实时功率,如果检测到功率突增或判断为感性负载,立即触发保护断电指令。
5. 典型场景解决方案举例
场景:共享自助健身房/台球厅
需求:用户扫码下单后,自动开启对应区域的灯光和空调(5000W)。实施
系统对接:商户SaaS系统集成芯步API。
下单流程:用户支付成功 -> SaaS后端调用
power_on-> 断路器吸合 -> 空调/灯光启动。计费逻辑:系统定时轮询断路器状态,若检测到功率低于10W(设备关机或待机),自动结束计费并调用
power_off。保护机制:通过API设置过载阈值(例如设置超过5500W自动断电),防止私接大功率违规电器。
场景:远程服务器机房重启
需求:监控服务器死机,需要远程断电重启。实施
接线:断路器安装在服务器电源前端。
脚本逻辑:Ping检测服务器IP。
若连续5次丢包 -> 判定死机。
调用API
power_off-> 等待5秒 -> 调用APIpower_on。自动化解决死机问题,无需人工到场。
6. 总结和需要注意的点
关于功率限制:请一定要将 “阻性5000W / 感性800W” 这一参数写入用户协议或系统手册。如果要控制空调压缩机、水泵等设备,必须外接交流接触器,否则会烧毁断路器触点 。
接口可靠性:本地WiFi控制依赖于路由器的稳定性。对于核心关键业务(如银行、医院),选用4G版本的断路器,可避免家庭宽带断网导致的控制失灵。
异常处理:在代码中必须包含 “断网重连” 和 “状态校验” 机制。每次下发指令后,间隔1-2秒调用状态查询接口,确认指令确实执行成功。