芯步的3路智能墙壁开关开放了完整的HTTP API接口,对接思路很清晰——本质上就是向指定设备ID的3条独立线路发送开/关指令。下面从准备工作、接口调用、代码示例到高级功能,完整梳理一遍。
一、 准备工作:拿到“钥匙”与“地址”
在写代码之前,我们需要先拿到几个关键凭证,就像是你要开门,得先有钥匙和门牌号。
获取 AppID 和 AppSecret
登录芯步官网,进入“工作台” -> “物联网控制台” -> “开发设置”。
这里你会看到两个字符串:AppID(应用ID,相当于用户名)和 AppSecret(开发者密码,相当于密钥)。注意:AppSecret 非常重要,千万不要泄露在网页前端代码里!
准备设备
确保你的“3路智能墙壁开关”已经通电,并且通过“芯步”的配网流程(小程序或控制台)连接到了WiFi(仅支持2.4G网络)。
在控制台的设备列表里,找到这个开关,记下它的 Device ID(设备ID,通常是一串数字,比如
820720)。这是你要操控的具体对象。
二、 接口 “三路” 的核心命令
芯步的接口非常友好,使用的是标准的 HTTP POST 请求。针对 3路开关,控制的核心参数在 order 字段里。
我们要记住这三个键名,分别对应开关背后的三根火线输出(L1、L2、L3):
| 线路 | 参数名 | 值含义 |
|---|---|---|
| 第1路 | power1 | 1 = 开启, 0 = 关闭 |
| 第2路 | power2 | 1 = 开启, 0 = 关闭 |
| 第3路 | power3 | 1 = 开启, 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 别搞混
AppID、DeviceID是两个完全不同的东西,复制粘贴的时候多看一眼。签名失败:大概率是时间戳(ts)不对,确保你的服务器时间和北京时间同步,误差太大会被拦截。
单火/零火:这个主要是安装电工考虑的事,对接接口时不需要关心,接口命令是一样的。
这套方案不仅适用于照明,三路完全独立,你甚至可以一路接灯、一路接风扇、一路接智能窗帘,通过你的业务系统(小程序/App/管理后台)统一调度,实现真正的家居或楼宇智能化。