CATALOG

芯步的AC1智能通断器开放HTTP接口,对接其实不复杂——核心就是签名计算和命令下发。下面我从实际开发角度,把整个流程串起来讲清楚。

一、这玩意儿能干啥?

咱们先搞清楚AC1是个什么东西。说白了,这就是一个可以用网络控制的继电器开关。你给它发个HTTP请求,它就能把电路接通或者断开。

用在自动贩卖机场景下,主要解决两个痛点:

  • 远程重启:机器死机了,不用派人跑一趟,直接远程断电再通电,搞定

  • 定时控制:比如晚上10点自动切断制冷,早上6点再开,省电

  • 异常保护:检测到电流异常,自动切断,防止烧机器

AC1额定功率2200W,10A电流,大部分贩卖机都够用。如果功率大,可以选AC4-30A那个版本,接口是一样的

二、准备工作

动手之前,先把这几样东西备齐:

  1. 买设备:芯步的AC1-10A智能通断器,淘宝京东都有

  2. 注册账号:去芯步官网注册一个开发者账号

  3. 创建工作台:控制台里创建一个工作台,系统会给你生成AppID和AppSecret

  4. 配网:用他们的批量配网小程序,把AC1连上你家的WiFi(注意:只支持2.4G)

配网成功后,在控制台能看到设备ID,是一串数字,记下来后面要用

三、接口对接的核心逻辑

AC1的接口设计得挺简单的,核心就是发POST请求

3.1 接口地址

3.2 签名怎么算?

这一步是很多新手卡壳的地方,其实不复杂,签名计算规则是:

sign = md5( md5(AppSecret) + ts )

什么意思呢?分三步:

  1. 把你的AppSecret做一次MD5加密

  2. 把第1步的结果和当前时间戳(秒)拼在一起

  3. 把拼好的字符串再做一次MD5

下面举个具体例子(假设你的AppSecret是abc123,当前时间戳是1699999999):

⚠️ 注意:时间戳是秒数,不是毫秒!别拿毫秒去算,否则签名死活不对。

3.3 请求体怎么写?

请求体是JSON格式,只需要传两个字段:deviceorder

  • power: 1 表示接通电路

  • power: 0 表示断开电路

就这么简单,开或者关

四、代码实战:三种语言的对接示例

Python版

Node.js版

纯命令行curl版(测试用)

用curl测试最方便,几行代码就能验证设备是不是通的

五、贩卖机场景的高级玩法

5.1 定时开关(省电模式)

贩卖机晚上基本没人买,一直开着制冷费电。可以设置晚上22:00关,早上6:00开。

AC1支持带延时的命令,比如:

这个命令的意思是:先接通,1小时(3600000毫秒)后自动断开。

你可以结合定时任务(比如cron)来实现复杂策略:

5.2 状态监控(实时推送)

AC1支持状态变化时主动推送消息到你指定的URL。需要在控制台配置一个回调地址。

当设备被手动按了开关,或者被远程控制后,芯步会POST一个消息到你的服务器,格式大概是:

这样你就能实时知道机器的通断状态,不用一直轮询

5.3 批量控制(多台贩卖机)

如果你有几十上百台贩卖机,一台一台发请求显然不行。芯步的接口支持一个请求控制多台设备

注意device字段里用逗号分隔多个设备ID就行了。非常适合做批量关机和批量重启的操作

六、常见坑点与避坑指南

坑1:时间戳问题签名用的时间戳要和请求参数里的ts保持一致。有些同学代码里ts生成两次,两次不一样,签名肯定错。用同一个变量。

坑2:WiFi频段AC1只支持2.4G WiFi,别连5G的。如果店铺里只有5G热点,得改一下设置。

坑3:响应延迟官方说的80-120ms延迟,实测正常情况下没问题。但WiFi信号不好的地方可能到500ms甚至超时。部署时注意设备离路由器不要太远

坑4:签名用md5不要用其他加密方式。芯步就是md5套md5,明文传输,注意AppSecret别泄露。在服务器端调用接口,别在前端暴露密钥。

七、完整流程总结

整个对接流程下来,大概需要的时间:

步骤耗时说明
注册+创建应用5分钟拿到AppID和AppSecret
设备配网3分钟/台用小程序批量配
写代码对接30分钟签名+请求,简单封装
测试+上线15分钟确认开关正常

加起来不到1小时就能跑通。芯步这套接口确实比较清爽,没有乱七八糟的SDK依赖,发HTTP请求就行。

如果你的贩卖机数量比较多(比如50台以上),再写个简单的管理界面,把设备ID都存进去,点一下按钮就能控制,比敲命令方便多了。

通断器产品方案:
如何在共享场馆照明系统控制中接入智能设备以实现用电数据上传控制
查看 >>
自动贩卖机电路管理:怎么将30A 智能开关接入到自己的项目中
查看 >>
怎样接入AC5-10A 定时控制开关来实现线路状态反馈控制
查看 >>
怎样二次开发AC5-10A 定时控制开关以实现实时能耗计量控制
查看 >>
共享茶室照明插座控制:如何把6600W 线路控制器对接到软件项目中
查看 >>
贩卖机场景方案:
自动贩卖机通断电控制:怎么将50A额定 11000W 断路器集成到软件项目中
查看 >>
自动贩卖机电路管理:如何将AC5-10A 智能控制模块集成到自己的项目中
查看 >>
自动贩卖机通断电控制:如何把60A带计量智能断路器接入到软件项目中
查看 >>
自动贩卖机电路管理:怎么将AC3-10A 计量版智能开关集成到软件项目中
查看 >>
自动贩卖机电路管理:怎么将30A 智能开关接入到自己的项目中
查看 >>
自动用途方案:
怎么对接AC3-10A 计量版智能控制器来实现过流自动断电控制
查看 >>
共享棋牌室自动照明控制:怎样把智能人体存在传感器吸顶雷达版集成到自己的项目中
查看 >>
怎样二次开发24 路远程控制设备联动模块以实现过流保护自动断电
查看 >>
怎样在私人影院包间场景中接入智能硬件以实现包间设备故障自动告警
查看 >>
怎么二次开发AC1-10A智能通断器以实现过流自动断电控制
查看 >>