CATALOG

芯步的3路智能墙壁开关开放了完整的HTTP API接口,对接思路很清晰——本质上就是向指定设备ID的3条独立线路发送开/关指令。下面从准备工作、接口调用、代码示例到高级功能,完整梳理一遍。

一、 准备工作:拿到“钥匙”与“地址”

在写代码之前,我们需要先拿到几个关键凭证,就像是你要开门,得先有钥匙和门牌号。

  1. 获取 AppID 和 AppSecret

    • 登录芯步官网,进入“工作台” -> “物联网控制台” -> “开发设置”。

    • 这里你会看到两个字符串:AppID(应用ID,相当于用户名)和 AppSecret(开发者密码,相当于密钥)。注意:AppSecret 非常重要,千万不要泄露在网页前端代码里!

  2. 准备设备

    • 确保你的“3路智能墙壁开关”已经通电,并且通过“芯步”的配网流程(小程序或控制台)连接到了WiFi(仅支持2.4G网络)

    • 在控制台的设备列表里,找到这个开关,记下它的 Device ID(设备ID,通常是一串数字,比如 820720)。这是你要操控的具体对象

二、 接口 “三路” 的核心命令

芯步的接口非常友好,使用的是标准的 HTTP POST 请求。针对 3路开关,控制的核心参数在 order 字段里。

我们要记住这三个键名,分别对应开关背后的三根火线输出(L1、L2、L3):

线路参数名值含义
第1路power11 = 开启, 0 = 关闭
第2路power21 = 开启, 0 = 关闭
第3路power31 = 开启, 0 = 关闭

举个栗子假如我想打开第一路的灯,同时关掉第二路的排风扇,第三路保持不变(或者不操作),order 数据就是这样的:

三、 实战:动手写代码

这里我们需要处理一个签名安全机制(Sign),防止接口被恶意篡改。别怕,其实就是几行数学计算。

签名生成规则(重要):sign = md5( md5(AppSecret) + ts )简单说就是:先把 AppSecret 进行一次 MD5加密,然后在后面拼接上当前的时间戳(ts),再对整个字符串做一次 MD5加密

1. 请求地址

2. 请求头 (Headers)

3. 请求体 (Body)

4. 代码示例(稍微口语化一点的 CURL 写法)

假设你在 Linux 服务器上或者用命令行测试,可以这样写:

四、 进阶玩法:给3路开关加点“智慧”

光能开和关还不够酷,芯步的接口还支持一些高级指令,特别是配合 三路 物理按键的场景:

1. 第一种场景:门禁联动(先断后通 / Reset)

假设你的第三路接的是电磁锁(或者门铃),你需要按一下,它接通5秒后自动断开(点动模式)。可以用 reset3 命令。

含义:针对第3路,立即断开,5000毫秒(5秒)后自动重新接通。

2. 第二种场景:卫生间排气扇(定时关闭)

比如第一路开了排气扇,怕忘记关,可以命令它1小时后自动关闭。

含义:打开第一路,并在3600000毫秒(1小时)后关闭它。注意:如果用户在1小时内手动关了,这个定时任务通常会自动取消。

3. 第三种场景:防误触(状态保持)

如果你的开关控制着重要的设备(比如服务器机房散热),不希望现场工作人员误碰物理按键关掉它。可以用“保持开”命令。

含义:锁定第1路为开启状态。如果有人手贱在墙上按物理按键关掉它,开关会在10秒后自动又把电接通。

五、 总结与避坑指南

总的来说,对接芯步的3路开关就是 “照着文档签个名,发个POST请求”

  • 网络问题:设备的WiFi信号一定要稳,虽然响应很快(80-120毫秒),但网络不好神仙也救不了

  • ID 别搞混AppIDDeviceID 是两个完全不同的东西,复制粘贴的时候多看一眼。

  • 签名失败:大概率是时间戳(ts)不对,确保你的服务器时间和北京时间同步,误差太大会被拦截。

  • 单火/零火:这个主要是安装电工考虑的事,对接接口时不需要关心,接口命令是一样的

这套方案不仅适用于照明,三路完全独立,你甚至可以一路接灯、一路接风扇、一路接智能窗帘,通过你的业务系统(小程序/App/管理后台)统一调度,实现真正的家居或楼宇智能化。