CATALOG

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 设备配网

  1. 上电:断路器通电,此时设备进入配网模式(通常指示灯快闪)。

  2. 连接

    • WiFi版:使用“芯步”官方App或依据其开放协议,通过 SoftAP 配网智能配网 将设备加入本地局域网。

    • 4G版:直接插入SIM卡,设备自动联网(无需配置WiFi)。

  3. 获取标识:配网成功后,在管理后台或App中获取该设备的唯一标识——Device ID (设备ID)。这是后续API调用中的核心参数。

4. 开放接口对接开发指南

芯步的25A断路器最核心的开放能力在于 HTTP 远程控制。任何能发起HTTP请求的编程语言均可调用。

4.1 接口通用规范

  • 协议: HTTPS / HTTP

  • 请求方法: POST (推荐) 或 GET

  • 数据格式: Application/JSON

  • 鉴权机制: 接口通常需要携带 AccessTokenAPI 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 的限制,如果你的负载是电机类(如麻将机、排风扇),有两种解决方案:

  1. 方案A:外接接触器

    • 让断路器的输出端接到一个220V交流接触器的线圈上,由接触器的主触点去控制大功率电机。这样断路器只承受线圈的小电流(瓦级),彻底解决功率限制问题。

  2. 方案B:软件限制

    • 在业务逻辑中设置软锁。例如,通过API获取设备实时功率,如果检测到功率突增或判断为感性负载,立即触发保护断电指令。

5. 典型场景解决方案举例

场景:共享自助健身房/台球厅

需求:用户扫码下单后,自动开启对应区域的灯光和空调(5000W)。实施

  1. 系统对接:商户SaaS系统集成芯步API。

  2. 下单流程:用户支付成功 -> SaaS后端调用 power_on -> 断路器吸合 -> 空调/灯光启动。

  3. 计费逻辑:系统定时轮询断路器状态,若检测到功率低于10W(设备关机或待机),自动结束计费并调用 power_off

  4. 保护机制:通过API设置过载阈值(例如设置超过5500W自动断电),防止私接大功率违规电器。

场景:远程服务器机房重启

需求:监控服务器死机,需要远程断电重启。实施

  1. 接线:断路器安装在服务器电源前端。

  2. 脚本逻辑:Ping检测服务器IP。

    • 若连续5次丢包 -> 判定死机。

    • 调用API power_off -> 等待5秒 -> 调用API power_on

    • 自动化解决死机问题,无需人工到场。

6. 总结和需要注意的点

  1. 关于功率限制:请一定要将 “阻性5000W / 感性800W” 这一参数写入用户协议或系统手册。如果要控制空调压缩机、水泵等设备,必须外接交流接触器,否则会烧毁断路器触点

  2. 接口可靠性:本地WiFi控制依赖于路由器的稳定性。对于核心关键业务(如银行、医院),选用4G版本的断路器,可避免家庭宽带断网导致的控制失灵。

  3. 异常处理:在代码中必须包含 “断网重连”“状态校验” 机制。每次下发指令后,间隔1-2秒调用状态查询接口,确认指令确实执行成功。