CATALOG

芯步的智能空开/通断器用的是通用HTTP接口,对接思路其实很简单——把它当成“可以通过网址调用的开关”就行。下面是一套完整的实操方案:

一、为什么能对接?(先搞清楚原理)

市面上很多智能空开用的是私有协议(比如Zigbee、Modbus),对接时需要搞网关、配协议转换器,非常麻烦。

但芯步的策略不一样:它的50A智能空开/通断器直接走 WiFi + HTTP接口

这意味着什么?意味着你可以用任何能发HTTP请求的语言(Java、PHP、Python、Go,甚至微信小程序的前端JS)去控制它。不需要买额外的网关,也不需要写复杂的驱动程序,就像你调淘宝的API获取订单一样简单。

核心逻辑

  • 设备联网:空开配网后,在云端保持在线。

  • 指令下发:你的软件向芯步的云端发一个HTTPS请求(带上签名、设备ID),云端收到指令后推送给设备,空开执行“合闸/分闸”。

二、准备工作(你需要拿到的两样东西)

在写代码之前,需要先到芯步的官网控制台做一点基础配置,大概花5分钟:

  1. 拿到AppID和AppKey:注册登录后,在“控制台” -> “应用管理”里可以看到。AppID相当于你的软件工号,AppKey是你的密码(签名用)。

  2. 拿到设备ID:把50A智能空开通上电,配好网(连上2.4G WiFi)。配网成功后,在控制台的“设备列表”里能看到一个字符串,那就是Device ID。

![设备ID获取示意图](注:实际使用时请参考官网截图)

三、实战对接(Java/PHP/Python示例)

这里用一个比较通用的PHP版本来演示,顺便解释一下思路,Java或Python同学直接对着改就行。

芯步的API地址通用格式是:https://api.thingboot.com/{AppID}/device/control/

核心步骤

  • 生成签名 sign:把参数按照字典序排序,拼接后MD5加密(具体看官网最新文档)。

  • 组装POST数据:告诉服务器你要控制哪个设备,让它开还是关。

下面这段代码是一个简单的封装示例:

注意:如果你们的项目是用微信小程序做的,代码逻辑也完全一致,只是把 curl 换成 wx.request 就行了

四、无人售货机的专属逻辑(进阶玩法)

如果只是远程开关,那太浪费了。结合售货机的业务场景,有几个关键细节需要注意:

1. 电流检测与库存联动

50A的智能空开通常不仅仅是开关,它还带有电量计量模块你可以定时去读一下电流值。

  • 场景:假设软件里显示“饮料已出货”,但检测到电机电流只波动了0.1秒就归零了。

  • 结论:大概率是卡货了。

  • 动作:软件自动触发“退款”或者“补发一次”指令,不用等客户打电话投诉。

2. 远程重启(死机修复)

无人售货机的主板偶尔会死机。

  • 骚操作:把售货机主板的电源接到这个50A空开上。

  • 逻辑:在软件里写一个“心跳检测”。如果每隔5分钟Ping售货机主板没反应,判定为死机。

  • 自动修复:调用空开API -> 断电(延迟5秒)-> 通电。相当于帮你去现场按了一下重启键,省了一趟路费。

3. 分时控制与节能

如果是做成人用品店或者24小时便利店外的机器:

  • 晚上11点后,客流量极低。

  • 利用API的定时任务功能,到了23:00自动断开(关掉灯箱、制冷剂待机),早上6:00自动合闸

  • 或者在做活动时,通过接口动态控制外挂广告灯的亮灭。

五、遇到问题怎么办?(避坑指南)

  1. 设备离线