CATALOG

芯步的智能插排/PDU设备通过开放HTTP API,可以让开发者用任何支持HTTP请求的编程语言进行远程控制。下面从接口机制、签名算法、对接流程到餐厅场景的落地实现,梳理一套完整的解决方案。

一、 背景与选型

在餐厅的数字化管理中,设备机柜(如收银机主机、网络路由器、交换机、音响功放等)往往24小时运行,不仅耗电,且容易出现死机、过热等故障。传统的处理方式是人工到现场拔插电源重启,效率极低。

采用芯步的 5位智能PDU(总控/分控)5位智能插排,可以将餐厅核心设备集中供电,并通过开放接口将其对接到餐厅现有的ERP系统、小程序或总部的运维中台。

二、 核心技术架构:开放接口

芯步的智能硬件核心优势在于其开放的HTTP接口,这意味着你不需要使用特定的物联网协议(如MQTT的重链接和维护),只需要标准的HTTP请求即可完成控制。

  • 通信协议:HTTP/HTTPS

  • 数据格式:JSON

  • 网络要求:设备支持2.4G WiFi,连接互联网即可。

  • 对接模式

    1. 公有云模式:调用芯步API域名。

    2. 私有化部署:如果餐厅数据安全要求比较高,可将控制逻辑部署在局域网服务器,设备直连内部服务器。

三、 关键对接流程

要将机柜插排对接到你的项目,需要按以下步骤准备和开发:

1. 环境准备

  • 注册账号:在芯步控制台注册开发者账号。

  • 获取凭证:在控制台获取 AppIDAppSecret(开发者密码)。这是调用API的钥匙。

  • 设备添加:将5位智能插排通电并配置Wi-Fi,在控制台获取该设备的唯一标识 Device ID

2. 签名机制

芯步的API通过动态签名验证身份,防止接口被恶意篡改。签名规则如下(通用逻辑):

  • 参数AppSecret(已做一次MD5) + ts(当前Unix时间戳)

  • 公式Sign = md5( md5(AppSecret) + ts )

3. 接口调用示例

假设你已经拿到了 AppIDDevice 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自动恢复供电”。

五、 部署注意事项

  1. 网络容灾:智能插排依赖Wi-Fi。如果Wi-Fi路由器本身就是被控制的设备(比如插在第2口),当执行重启第2口时,插排会暂时断网。芯步的设备通常具备断网记忆本地延时恢复功能,即使断网,预设的指令(如reset)依然会在本地执行,不会因为网络断了就卡住。

  2. 接口超时处理:HTTP请求是异步的。下发命令后,不要立刻假设设备已动作。结合查询接口或利用计量功能(看功率变化)来确认设备状态。

  3. 安全性:签名参数 ts (时间戳)严格控制在5分钟误差内,防止重放攻击。AppSecret 严禁存储在客户端(如小程序前端),必须由你的业务后端代理请求。

六、 总结

通过芯步的开放接口,餐厅设备机柜的电源管理不再是孤立的硬件操作。你可以像调用“发送短信验证码”一样调用HTTP接口来切断或接通电源。这套方案能够:

  • 降低运维成本:减少夜间断电的人工操作和死机导致的深夜到店维护。

  • 提升效率:1分钟内完成远程恢复网络。

  • 安全节能:实时监测功率,异常断电及时报警。