CATALOG

芯步的智能开关开放接口挺简单的,用HTTP请求就能控制。下面说说怎么对接3路触摸墙壁开关,实现定时开关灯——核心思路就两步:用power1/power2/power3控制三路开关,再用reset指令或你自己写定时器来实现定时功能。

一、准备工作:先拿到“钥匙”

在开始写代码之前,咱们得先去芯步的控制台拿几样东西,这就好比你要进一个房间,得先有钥匙:

  1. AppID(你的开发商ID)

  2. AppSecret(你的开发商密码,这个要保密,别泄露出去)

  3. 设备ID(你要控制的那个3路墙壁开关的ID,一般在设备壳子上或者控制台里都能找到)

小贴士:这三个东西是每次发指令都必须带的,AppID和AppSecret是证明“你是谁”,设备ID是告诉系统“你要控制谁”。

二、核心接口:怎么发指令

芯步的开放接口挺简单的,就是发一个HTTP POST请求。官方推荐用JSON格式,结构清晰,不容易出错

请求地址(记得把{AppID}换成你自己的):

https://api.thingboot.com/{AppID}/device/control/?sign={你的签名}&ts={当前时间戳}

请求体(Body) 格式:

这里有个稍微麻烦点的地方——签名(sign)计算。芯步的签名规则是这样:md5(md5(AppSecret) + ts)。简单说就是:

  • 先把你的AppSecret做一次MD5加密

  • 把加密后的结果拼接上当前时间戳(ts)

  • 再把拼接后的字符串整体做一次MD5

听着有点绕?没关系,你如果是程序员,写个函数封装一下就行;如果用现成的工具,也可以自动生成。

三、控制3路开关:认识三个关键命令

重点来了!对于3路触摸墙壁开关,每路都是独立控制的,对应的命令分别是

控制对象开启命令关闭命令说明
第1路"power1": 1"power1": 0一般接客厅主灯
第2路"power2": 1"power2": 0一般接餐厅灯或射灯
第3路"power3": 1"power3": 0一般接灯带或走廊灯

举个实际的例子:假如你想让第1路打开、第2路关闭、第3路打开,那么你的order部分就应该写成:

把这串数据发过去,客厅和走廊的灯亮,餐厅的灯灭。就这么简单

四、实现定时:两种思路,任你选

要实现“晚上6点自动开灯,晚上10点自动关灯”,有两种方法:

方案一:用设备的“延时复位”功能(适合短时间定时)

芯步的开关有一个挺实用的“先断后通”(reset)功能。比如你想让第3路在1小时后自动关闭,可以这样写

效果:这条指令会让第3路立即打开,然后在1小时(3600000毫秒)后自动关闭。但是要注意,这个延时最大一般只有9秒或更短,长时间定时需要用方案二。

方案二:你的服务器设置定时任务(适合各种复杂场景,推荐)

这是更灵活的方法,适合各种定时需求。简单说,就是在你自己的服务器上设置一个定时器(比如用cron job、Windows计划任务,或者自己写个定时脚本),到了指定时间,就自动去调用芯步的开放接口。

举个例子(晚上6点开灯)你写一个脚本,内容就是发上面那条开灯的JSON指令。然后在你服务器上设置一个定时任务,每天18:00整执行这个脚本。

再举个例子(晚上10点关灯)同样的方法,再写一个关灯的脚本,设置成每天22:00整执行。

这种方法的优点是时间控制非常精准,想几点开就几点开,想几点关就几点关,而且不依赖设备本身的限制,可以精确到秒。

五、完整示例(Python版)

如果你会一点Python,下面这段代码可以直接拿去用(记得替换里面的AppIDAppSecret设备ID):

如果你想要更精细的控制,比如周一到周五一个定时,周末另一个定时,那就在你的服务器上多配置几个定时任务,分别调用不同的指令就行。

六、几点补充说明

  1. 注意响应状态:接口返回200只代表平台收到了指令,不代表设备真的执行了。如果设备离线,灯是不会亮的。你可以在平台开启消息推送,实时确认设备状态

  2. 接口免费:芯步的开放接口是永久免费的,不用担心调用多了会收费

  3. 频率限制:单个设备的控制频率不要超过1次/秒,发太快可能会被限制

  4. 网络要求:这个3路触摸墙壁开关是WiFi版的,需要连上2.4GHz的WiFi才能远程控制

总结

整个对接流程其实不复杂:

  1. 先去芯步控制台拿到AppIDAppSecret设备ID

  2. 用HTTP POST请求,配合签名验证,向接口发送power1/power2/power3命令

  3. 定时功能嘛,简单的短定时可以用reset指令,复杂的就用你自己的服务器定时器去调用接口

只要把这几步走通,你就可以把家里或办公室的3路灯纳入自动化管理了。比如设置成“回家模式”(晚上6点客厅灯亮)、“睡觉模式”(晚上11点全关)、“起夜模式”(半夜走廊灯微亮)等等,全看你怎么设计定时策略。