CATALOG

芯步的25A智能限流断路器开放HTTP API接口,支持远程分合闸、电量采集和过载保护。以下方案涵盖硬件选型、API接入流程及签名算法实现,帮助你在3-5天内完成集成开发。

1. 产品选型与核心特性

在集成之前,首先需要明确所使用的硬件规格。针对门店(如餐饮、零售、健身房等)的25A电流需求,推荐的设备具备以下核心参数与能力:

  • 型号参考:UNI-DLQ-25A-4G(或同类智能控制器)

  • 核心功能

    • 远程通断:支持独立控制1-4路电路,适用于灯光、空调、厨房设备、招牌电源的分路管理

    • 多重保护:具备限流、过载、过压保护功能,当电流超过25A阈值时自动切断,防止火灾

    • 数据采集:实时回传电压、电流、功率及开关状态。

  • 通信方式:4G Cat.1(无需配网,即插即用)或Wi-Fi/以太网,适应门店复杂的网络环境

2. 总体集成架构

要将断路器集成到你的自有项目中(如收银系统、总部SaaS管控平台或小程序),架构分为三层:

1. 基础设施层(硬件)安装智能断路器替换原有老旧断路器,接入门店220V总进线或大功率设备支路。

2. 数据传输层(云平台)设备通过4G信号直接连接芯步云平台,或通过用户自建的私有化MQTT服务器接收数据

3. 业务应用层(你的项目)你的业务系统通过调用芯步开放的 HTTP API 接口,向指定设备下发指令(通/断),或订阅设备上报的状态变更。

3. 集成开发关键步骤

3.1 环境准备与凭证获取

在开始编码前,需要先在芯步开发者后台完成配置:

  1. 注册与创建应用:登录芯步控制台,创建一个新的应用项目(App),系统将生成唯一的 AppIDAppSecret。这是后续接口调用的身份凭证

  2. 设备绑定:将购买的25A断路器添加至控制台,获取唯一的 设备ID(Device ID)

  3. 网络确认:若使用4G版本,设备通电后自动连接云端;若使用WiFi版本,需通过“配网模式”将设备连入门店2.4G WiFi

3.2 接口调用与签名机制

芯步的接口采用 HTTP POST 请求,并对所有请求进行了签名加密以保安全

  • 请求地址https://api.thingboot.com/{AppID}/device/control/

  • 核心参数

    • device:目标设备的ID。

    • order:控制指令(JSON字符串)。

  • 签名算法(Sign)为确保安全性,请求头需携带动态签名。签名生成逻辑如下:Sign = MD5( MD5(AppSecret) + ts )即:将 AppSecret 进行一次MD5加密,拼接上当前的时间戳 ts,再进行一次MD5加密

3.3 核心控制指令示例

针对25A断路器的控制逻辑非常直观。你可以通过下发不同的 order 参数来实现通路控制(假设代码环境为Python/JavaScript伪代码,逻辑通用):

1. 单路独立控制

这是最常用的场景,例如店员下班后远程关闭“空调回路”或“照明回路”。

指令详解

  • power1 代表第一路继电器。

  • 1 代表接通(闭合),0 代表断开

2. 批量与场景控制

针对开店/关店场景,往往需要同时操作多路设备。

此类指令适用于自动化脚本,例如每天早上6点自动重启收银机或网络设备

3.4 代码实现逻辑

在后端服务中,可以封装一个简单的控制函数。逻辑如下:

  1. 生成时间戳 ts

  2. 计算 Sign = md5(md5(AppSecret) + ts)

  3. 构造POST请求,Header中携带签名参数。

  4. 发送JSON Body:{"device": "xxx", "order": "{\"power1\":\"0\"}"}

注意:请求时需将 order 作为字符串传递,而不是直接嵌套JSON对象

4. 高级功能与安全策略

4.1 数据监控与告警

除了控制,集成还应包括“感知”。通过接口不仅仅能下发命令,也能查询状态。

  • 实时状态读取:调用设备状态查询接口,获取当前的电压、电流及开关状态。

  • 联动策略:可以在你的项目中设置逻辑,例如:当监测到电流超过25A持续10秒,你的系统自动触发“断电保护”指令,并发送微信/短信告警给店长

4.2 本地局域网控制

如果你的项目运行在门店本地服务器上,且对稳定性要求比较高,可以利用设备的局域网通信能力。芯步设备支持在无外网环境下,直接通过本地HTTP API控制,无需经过云端,降低延迟

4.3 安全

  • 密钥隔离:不要把 AppSecret 写在前端代码(如门店大屏的前端JS或小程序前端)中,必须由你的后端业务服务器代理转发请求,防止泄露。

  • 操作日志:在你的项目中记录每一次远程断闸的操作人和操作原因,以便后续审计

5. 集成价值总结

通过集成25A智能限流断路器,你的项目将实现以下升级:

  • 运维效率:解决门店“忘记关空调/灯光”的痛点,夜间自动巡检断电,预计节省电费15%-20%。

  • 安全保障:电路异常时系统自动断电并报警,将“事后补救”变为“事前预防”

  • 智能化程度:让门店硬件设备具备数字化接口,融入整体的新零售或智慧办公解决方案中。