芯步的智能插排/PDU设备通过开放HTTP API,可以让开发者用任何支持HTTP请求的编程语言进行远程控制。下面从接口机制、签名算法、对接流程到餐厅场景的落地实现,梳理一套完整的解决方案。
一、 背景与选型
在餐厅的数字化管理中,设备机柜(如收银机主机、网络路由器、交换机、音响功放等)往往24小时运行,不仅耗电,且容易出现死机、过热等故障。传统的处理方式是人工到现场拔插电源重启,效率极低。
采用芯步的 5位智能PDU(总控/分控) 或 5位智能插排,可以将餐厅核心设备集中供电,并通过开放接口将其对接到餐厅现有的ERP系统、小程序或总部的运维中台。
二、 核心技术架构:开放接口
芯步的智能硬件核心优势在于其开放的HTTP接口,这意味着你不需要使用特定的物联网协议(如MQTT的重链接和维护),只需要标准的HTTP请求即可完成控制。
通信协议:HTTP/HTTPS
数据格式:JSON
网络要求:设备支持2.4G WiFi,连接互联网即可。
对接模式
公有云模式:调用芯步API域名。
私有化部署:如果餐厅数据安全要求比较高,可将控制逻辑部署在局域网服务器,设备直连内部服务器。
三、 关键对接流程
要将机柜插排对接到你的项目,需要按以下步骤准备和开发:
1. 环境准备
注册账号:在芯步控制台注册开发者账号。
获取凭证:在控制台获取
AppID和AppSecret(开发者密码)。这是调用API的钥匙。设备添加:将5位智能插排通电并配置Wi-Fi,在控制台获取该设备的唯一标识
Device ID。
2. 签名机制
芯步的API通过动态签名验证身份,防止接口被恶意篡改。签名规则如下(通用逻辑):
参数
AppSecret(已做一次MD5) +ts(当前Unix时间戳)公式
Sign = md5( md5(AppSecret) + ts )
3. 接口调用示例
假设你已经拿到了 AppID、Device ID 和计算好的 Sign,以下是如何控制插排第3个孔位开启的示例。
API 地址:POST https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}
请求体 (Body):
核心代码逻辑(伪代码/概念):你的后端服务器需要构建一个HTTP POST请求。餐厅的机柜插排5个孔位,分控是核心需求(例如只重启路由器,不影响收银机)。对于分控设备,order 参数应构建为:
开启第3孔:
{"power3":"1"}关闭第3孔:
{"power3":"0"}一键全开:
{"power":"1"}
4. 机柜场景的特殊指令
为了应对机柜设备(如路由器)死机无法进入后台但急需重启的场景,接口通常支持 “先断后通” 功能。
场景:餐厅网络断了,人工操作需重启路由器。
命令
{"reset":"3000"}含义:系统自动将该插座断电,等待3秒(3000毫秒)后自动恢复通电。这是解决设备假死最常用的接口功能。
四、 餐厅场景实施方案
1. 物理部署与排线
设备选型:选用 5位独立分控计量版 PDU。5位可以分别接入:①收银主机 ②网络主路由器 ③交换机 ④监控硬盘录像机 ⑤音响功放/排队叫号系统。
关键点不将总闸或大功率空调接入该插排(通常额定单孔位1500W,总额定2500W-3000W),仅用于弱电机柜设备。
2. 软件功能开发在你的餐厅管理后台或运维App中,开发以下模块:
设备看板
展示当前5个孔位的状态(图标:绿色通电/灰色断电)。
显示实时功率(计量版支持),如果功率为0,说明设备宕机或电源适配器损坏。
远程重启
界面设计一个“重启路由器”按钮,后台逻辑调用接口:先发送
{"power2":"0"},延迟5秒后发送{"power2":"1"}(或直接调用reset指令)。
定时任务
芯步接口支持定时任务配置。你可以设定每周一凌晨3点自动关闭所有机柜设备,3点05分按顺序启动(先开主路由等2分钟,再开收银机),达到省电并清理缓存的效果。
3. 报警联动机制结合餐厅的运营逻辑:
联动规则:如果总部监控系统检测到某门店网络Ping不通(离线)。
执行:自动触发服务器脚本 -> 调用API查询智能插排状态 -> 确认第2口(路由器)电流为0或状态为开 -> 强制执行一次
reset指令 -> 恢复网络。通知:通过接口返回的结果,发送企业微信/钉钉通知:“XX餐厅路由器已于10:23自动恢复供电”。
五、 部署注意事项
网络容灾:智能插排依赖Wi-Fi。如果Wi-Fi路由器本身就是被控制的设备(比如插在第2口),当执行重启第2口时,插排会暂时断网。芯步的设备通常具备断网记忆和本地延时恢复功能,即使断网,预设的指令(如reset)依然会在本地执行,不会因为网络断了就卡住。
接口超时处理:HTTP请求是异步的。下发命令后,不要立刻假设设备已动作。结合查询接口或利用计量功能(看功率变化)来确认设备状态。
安全性:签名参数
ts(时间戳)严格控制在5分钟误差内,防止重放攻击。AppSecret严禁存储在客户端(如小程序前端),必须由你的业务后端代理请求。
六、 总结
通过芯步的开放接口,餐厅设备机柜的电源管理不再是孤立的硬件操作。你可以像调用“发送短信验证码”一样调用HTTP接口来切断或接通电源。这套方案能够:
降低运维成本:减少夜间断电的人工操作和死机导致的深夜到店维护。
提升效率:1分钟内完成远程恢复网络。
安全节能:实时监测功率,异常断电及时报警。