CATALOG

共享台球室这种模式,虽然好玩,但最怕的就是“电”出问题——万一哪个球桌漏电,或者客人乱接大功率电器导致跳闸,老板大半夜得跑过去送电,这就太折腾了。今天我们聊一聊怎么用芯步的50A智能空开和它的HTTP接口,把这些烦心事儿一网打尽。

一、痛点场景:为什么台球室需要“会断网的空气开关”?

共享台球室通常24小时营业,且多为无人值守模式。传统的空气开关(断路器)虽然能在过载、短路时跳闸保护电路,但存在两个致命痛点:

  1. 跳闸后“哑巴”:老板不知道跳闸了,直到客人打电话投诉才知道断电。

  2. 恢复难:必须派人去现场推闸,夜间成本比较高。

芯步的 50A智能大功率断路器 正好解决这两个问题。它不仅能承受台球室多台空调、饮水机、自助售货机的同时高负载(最高10000W阻性负载),还开放了 HTTP API 接口

我们要做的,就是把“推闸”这个物理动作,变成软件里的一个按钮。

二、准备工作:硬件选型与平台注册

在写代码之前,我们需要先让设备“上网”。

  1. 硬件选型选择 智能大功率断路器[计量版]或[计量数显版] 。除了通断控制,计量版还能读取电压、电流、功率,这对后续做能耗分析或过载预警非常有帮助

  2. 注册与创建

    • 访问芯步官网,注册账号并“创建工作台”。

    • 进入“物联网控制台”。

  3. 设备配网

    • 使用微信小程序“芯步”或控制台的“网络配置”功能,将现场的 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 )

具体操作步骤:

  1. 获取 AppSecret:在工作台的“开发设置”中找到密钥。

  2. 计算第一层MD5:将 AppSecret 进行 MD5 加密,得到 str1

  3. 拼接时间戳:获取当前的 Unix 时间戳(秒级),例如 1714896000。将 str1 直接拼接上 ts,得到 str2 = str1 + "1714896000"

  4. 计算第二层MD5:对 str2 再次进行 MD5 加密,得到最终的 sign

  5. 传递参数:在请求 URL 中带上 signts

注意:每次请求都必须重新计算签名,且 ts 必须与签名计算时使用的一致。

2. 核心操作:下发控制命令

签名搞定后,就可以控制开关了。

  • 远程合闸(开电)台球客人在小程序下单后,系统自动执行这个命令。

  • 远程分闸(断电)订单结束或检测到异常时执行。

  • 定时断电这是共享场景最好用的功能。比如客人买了1小时,你可以下发一个延时任务,1小时后自动断电,防止客人超时不续费占座。

    这个 reset 命令在芯步的产品中经常出现,意为“先通后断”,非常适合按时计费场景

3. 进阶防护:获取实时电参

如果你想做一个更高级的功能,比如“功率过大自动保护”或者“实时查看当前用了多少度电”,你需要主动查询设备状态。

虽然文档中未详细列出查询接口,但在芯步的生态中,通常是通过获取设备状态接口来实现。

你可以通过以下方式获取:

  1. 主动查询:调用 /device/status/ 类接口(具体路径见官方API文档)获取实时 current(电流)、power(功率)。

  2. 被动推送:设置 Webhook(消息推送),当设备检测到功率超过阈值(比如球桌马达卡死导致电流飙升)时,平台会主动 POST 数据给你的服务器,你可以立刻触发断电保护

四、实战逻辑:对接共享台球室业务

假设你是开发者,将 50A 智能空开嵌入你的“共享台球系统”,业务逻辑通常是这样的:

  1. 绑定流程老板在后台添加设备,输入设备ID,系统自动调用接口查询设备在线状态,绑定到对应的“XX号台球桌”。

  2. 下单通电用户扫码 -> 支付成功 -> 你的后端服务器计算签名 -> 调用控制接口 {"power":1}:接口调用成功后,将该设备的状态存入 Redis,防止重复下单冲突。

  3. 计费心跳由于 reset 命令只能做到定时断,但无法应对“中途续费”。如果客人续费1小时,你需要做的是:

    • 方案A:先查询当前状态,如果没断电,下发 {"reset": 3600000} 覆盖之前的定时任务(前提是设备支持覆盖指令)。

    • 方案B:如果设备不支持覆盖,你需要自己维护服务器端的定时任务。到了1小时后,服务器检查数据库订单状态:如果未续费,则下发断电指令;如果已续费,不发指令,等下一个周期。

  4. 异常断电告警如果客人打着球突然没电了,可能不是订单结束,而是 漏电过载 (比如插了大功率电暖器)。

    • 你的系统需要有一个定时任务,每5分钟通过接口获取一次设备状态。

    • 如果发现状态是 offlinepower=0 但订单未结束,立即发送“电路异常警报”给管理员和客人。

五、总结与避坑指南

将芯步的50A智能空开对接到你的软件项目中,技术门槛其实不高,核心就是 HTTP 请求 + MD5 签名。只要搞定了签名规则,你就拥有了远程控制实体电线的能力。

这里有三点经验分享给你:

  1. 时间戳同步:保证你服务器的时间是准确的网络时间,不要差太多,否则会报签名过期。

  2. 本地局域网控制:芯步也支持局域网控制。如果你的台球室管理后台就在现场局域网内,走局域网API延迟更低,也不怕外网断网

  3. 计量数据的价值:别只把它当开关用。50A计量版返回的电流数据非常有用。比如你设定如果电流持续 5 分钟超过 45A(接近阈值),说明线路快过载了,可以先发个预警给老板,避免在营业高峰期跳闸崩盘。

通过对这些接口的调用,你的无人台球室就真正实现了“手中有电,心里不慌”。

断路器产品方案:
如何对接60A计量版空开以实现电流电压功率计量监测
查看 >>
小型商铺总控电路:怎么将40A远程控制断路器接入到软件项目中
查看 >>
实验室电源管理:怎么将智能断路器35A接入到自己的项目中
查看 >>
如何接入智能断路器20A来实现远程通断控制
查看 >>
如何对接50A智能空开来实现延时通断控制
查看 >>
电路场景方案:
怎么在自助洗车机电路控制中接入智能设备来实现远程通断控制
查看 >>
安防设备交流电路控制:怎样将AC4-10A智能通断开关对接到项目中
查看 >>
共享充电宝柜电路管理:如何将50A带计量智能断路器集成到软件项目中
查看 >>
商场展柜电路保护:如何将40A带计量数显智能断路器接入到自己的项目中
查看 >>
小型商铺总控电路:怎么将40A远程控制断路器接入到软件项目中
查看 >>
保护用途方案:
怎么二次开发智能断路器|35A来实现过压欠压保护控制
查看 >>
如何二次开发50A带计量数显导轨式智能断路器以实现过压欠压保护控制
查看 >>
怎么二次开发5位分控插排以实现过流过载保护控制
查看 >>
如何对接智能线路通断器 10A-AC2以实现功率超限保护
查看 >>
咖啡厅电器回路保护:怎么将AC1-10A 定时控制开关接入到自己的项目中
查看 >>