芯步的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 环境准备与凭证获取
在开始编码前,需要先在芯步开发者后台完成配置:
注册与创建应用:登录芯步控制台,创建一个新的应用项目(App),系统将生成唯一的 AppID 和 AppSecret。这是后续接口调用的身份凭证。
设备绑定:将购买的25A断路器添加至控制台,获取唯一的 设备ID(Device ID)。
网络确认:若使用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 代码实现逻辑
在后端服务中,可以封装一个简单的控制函数。逻辑如下:
生成时间戳
ts。计算
Sign = md5(md5(AppSecret) + ts)。构造POST请求,Header中携带签名参数。
发送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%。
安全保障:电路异常时系统自动断电并报警,将“事后补救”变为“事前预防”。
智能化程度:让门店硬件设备具备数字化接口,融入整体的新零售或智慧办公解决方案中。