共享台球室这种模式,虽然好玩,但最怕的就是“电”出问题——万一哪个球桌漏电,或者客人乱接大功率电器导致跳闸,老板大半夜得跑过去送电,这就太折腾了。今天我们聊一聊怎么用芯步的50A智能空开和它的HTTP接口,把这些烦心事儿一网打尽。
一、痛点场景:为什么台球室需要“会断网的空气开关”?
共享台球室通常24小时营业,且多为无人值守模式。传统的空气开关(断路器)虽然能在过载、短路时跳闸保护电路,但存在两个致命痛点:
跳闸后“哑巴”:老板不知道跳闸了,直到客人打电话投诉才知道断电。
恢复难:必须派人去现场推闸,夜间成本比较高。
芯步的 50A智能大功率断路器 正好解决这两个问题。它不仅能承受台球室多台空调、饮水机、自助售货机的同时高负载(最高10000W阻性负载),还开放了 HTTP API 接口 。
我们要做的,就是把“推闸”这个物理动作,变成软件里的一个按钮。
二、准备工作:硬件选型与平台注册
在写代码之前,我们需要先让设备“上网”。
硬件选型选择 智能大功率断路器[计量版]或[计量数显版] 。除了通断控制,计量版还能读取电压、电流、功率,这对后续做能耗分析或过载预警非常有帮助 。
注册与创建
访问芯步官网,注册账号并“创建工作台”。
进入“物联网控制台”。
设备配网
使用微信小程序“芯步”或控制台的“网络配置”功能,将现场的 2.4G WiFi 信息广播给设备。设备指示灯常亮即代表上线 。
三、核心技术:HTTP API 对接流程
芯步的接口设计非常简洁,基于 HTTP 协议,无论你的后端是 Java、Python、PHP 还是 Node.js,都可以轻松集成。
核心请求地址结构如下:https://api.thingboot.com/{AppId}/device/control/?sign={签名}&ts={时间戳}
这里最坑爹也最关键的就是 签名算法。如果不注意,很容易报签名错误。
1. 关键步骤:动态签名生成
根据官方文档,签名算法规则如下 YourSign = md5( md5(AppSecret) + ts )
具体操作步骤:
获取 AppSecret:在工作台的“开发设置”中找到密钥。
计算第一层MD5:将
AppSecret进行 MD5 加密,得到str1。拼接时间戳:获取当前的 Unix 时间戳(秒级),例如
1714896000。将str1直接拼接上ts,得到str2 = str1 + "1714896000"。计算第二层MD5:对
str2再次进行 MD5 加密,得到最终的sign。传递参数:在请求 URL 中带上
sign和ts。
注意:每次请求都必须重新计算签名,且 ts 必须与签名计算时使用的一致。
2. 核心操作:下发控制命令
签名搞定后,就可以控制开关了。
远程合闸(开电)台球客人在小程序下单后,系统自动执行这个命令。
远程分闸(断电)订单结束或检测到异常时执行。
定时断电这是共享场景最好用的功能。比如客人买了1小时,你可以下发一个延时任务,1小时后自动断电,防止客人超时不续费占座。
这个
reset命令在芯步的产品中经常出现,意为“先通后断”,非常适合按时计费场景 。
3. 进阶防护:获取实时电参
如果你想做一个更高级的功能,比如“功率过大自动保护”或者“实时查看当前用了多少度电”,你需要主动查询设备状态。
虽然文档中未详细列出查询接口,但在芯步的生态中,通常是通过获取设备状态接口来实现。
你可以通过以下方式获取:
主动查询:调用
/device/status/类接口(具体路径见官方API文档)获取实时current(电流)、power(功率)。被动推送:设置 Webhook(消息推送),当设备检测到功率超过阈值(比如球桌马达卡死导致电流飙升)时,平台会主动 POST 数据给你的服务器,你可以立刻触发断电保护 。
四、实战逻辑:对接共享台球室业务
假设你是开发者,将 50A 智能空开嵌入你的“共享台球系统”,业务逻辑通常是这样的:
绑定流程老板在后台添加设备,输入设备ID,系统自动调用接口查询设备在线状态,绑定到对应的“XX号台球桌”。
下单通电用户扫码 -> 支付成功 -> 你的后端服务器计算签名 -> 调用控制接口
{"power":1}。:接口调用成功后,将该设备的状态存入 Redis,防止重复下单冲突。计费心跳由于
reset命令只能做到定时断,但无法应对“中途续费”。如果客人续费1小时,你需要做的是:方案A:先查询当前状态,如果没断电,下发
{"reset": 3600000}覆盖之前的定时任务(前提是设备支持覆盖指令)。方案B:如果设备不支持覆盖,你需要自己维护服务器端的定时任务。到了1小时后,服务器检查数据库订单状态:如果未续费,则下发断电指令;如果已续费,不发指令,等下一个周期。
异常断电告警如果客人打着球突然没电了,可能不是订单结束,而是 漏电 或 过载 (比如插了大功率电暖器)。
你的系统需要有一个定时任务,每5分钟通过接口获取一次设备状态。
如果发现状态是
offline或power=0但订单未结束,立即发送“电路异常警报”给管理员和客人。
五、总结与避坑指南
将芯步的50A智能空开对接到你的软件项目中,技术门槛其实不高,核心就是 HTTP 请求 + MD5 签名。只要搞定了签名规则,你就拥有了远程控制实体电线的能力。
这里有三点经验分享给你:
时间戳同步:保证你服务器的时间是准确的网络时间,不要差太多,否则会报签名过期。
本地局域网控制:芯步也支持局域网控制。如果你的台球室管理后台就在现场局域网内,走局域网API延迟更低,也不怕外网断网 。
计量数据的价值:别只把它当开关用。50A计量版返回的电流数据非常有用。比如你设定如果电流持续 5 分钟超过 45A(接近阈值),说明线路快过载了,可以先发个预警给老板,避免在营业高峰期跳闸崩盘。
通过对这些接口的调用,你的无人台球室就真正实现了“手中有电,心里不慌”。