CATALOG

芯步的智能开关开放了标准HTTP接口,签名算法清晰,从下单到调通确实可以在1小时内完成。下面按实战顺序,把接入过程拆成四步来讲。

一、准备工作:拿到开门的“钥匙”

在写代码之前,需要先到芯步官网获取一些关键信息,你可以理解为开门的钥匙:

  1. 注册账号并创建“工作台”:登录官网后,创建一个“工作台”(可以理解为你的项目空间)。

  2. 获取AppID和AppSecret:进入工作台的开发设置,这里有两个关键字符串:

    • AppID:就像你的“用户名”,接口知道是谁在调用。

    • AppSecret:这是你的“密码”,千万不能把它写在网页或APP的代码里,只能在后端服务器使用。

  3. 准备好智能开关设备

    • 购买芯步的智能墙壁开关(有1路/2路/3路可选,你想控制两个设备就选2路)。

    • 按照说明书物理接线(记得断电操作),然后通过小程序给它配网。配网成功后,在控制台的“设备列表”里就能看到一个设备ID(比如820720),这就是你待会儿要控制的那个开关。

二、核心代码实现

芯步采用的是签名验证机制,比起复杂的OAuth,这个简单多了。

请求地址(POST方法):

签名生成规则(这是核心):官方用的是双重MD5sign = md5( md5(AppSecret) + ts )简单说,就是把你的AppSecret做一次MD5加密,然后拼接上当前的时间戳,再把整个字符串做一次MD5

搞定!接下来上代码示例(Python)

如果返回的状态码是200,且包含"code":0之类的成功标识,说明你的灯已经瞬间点亮了。整个响应时间通常在80-120毫秒左右,体感非常快

三、玩转场景

这个接口不只是能开和关,它还能做一些复杂的自动化场景,逻辑放在云端,开关只需要执行就行:

1. 定时关闭

经常遇到楼道灯忘了关的情况,你可以通过接口告诉他:“打开,但是1小时后自动关”:

这里的reset指的是先接通(先通),然后过这么多毫秒后断开(后断)。3600000就是1小时

2. “暂态”保持

某些公共场合的灯,如果有人手动关了,可能是误触,你希望过一会儿它自己又恢复?可以用“状态保持”功能:

意思是:强制第一路保持开(keep:1),即使用户手动把它按关了,10秒(revert:10)后它也会自动弹回来

四、安装注意事项

这里分享两个小经验:

  1. 关于单火和零火:老房子通常是“单火”布线(开关盒里只有火线),选单火版开关,不用改线。新装修选零火版,稳定性更高,能带的灯具功率也更大

  2. WiFi信号:开关是靠WiFi联网的,藏在墙里的86底盒对WiFi信号有一定屏蔽,安装前用手机在那个位置测一下信号强度,避免掉线。

总结一下流程下单硬件 -> 安装通电配网 -> 复制ID和密钥 -> 复制上面的Python代码改几个参数 -> 运行!