CATALOG

芯步的智能开关开放了简洁的HTTP接口,二次开发门槛很低——核心就是构造一个带签名的POST请求,告诉平台你想控制哪个设备的哪一路。下面我会从准备工作、接口调用、代码示例到常见场景,帮你把这件事讲清楚。

一、准备工作

在写代码之前,你得先搞定三样东西:

  1. 一个芯步的开发者账号:去官网注册,进了工作台创建个项目,就能拿到 AppIdAppSecret(相当于你的API钥匙)

  2. 一台“智能墙壁电源开关”:设备得先配好网。你就直接把它当普通开关装上(注意断电操作!),然后在App里让家里WiFi认它。确认它在工作台里显示“在线”,这是发命令的前提

  3. 设备ID:在工作台设备列表里找到那个一长串数字,复制下来待会用

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

芯步这接口设计得挺实在,走的是标准HTTP POST,返回也是JSON,用啥编程语言都能调

请求地址:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求方式: POST(数据格式:JSON)

请求体里必须带上俩参数:

  • device:就是上面说的设备ID(String格式)

  • order:这是关键,里面装的是控制命令(JSON对象)

三、聚焦“1路开关”的控制命令(Order)

既然是1路的开关,命令格式就非常直观,主要看你想让这盏灯做什么:

1. 基础开关(最常用)直接告诉它是开还是关。比如“打开灯”:

“关闭灯”:

注意:命令里的数字 1 就是“1路”的意思

2. 先断后通(复位模式)有些场景(比如控制门禁或特殊设备)需要先断电几秒再自动恢复。比如关掉灯,2秒后再自动打开:

数值2000是毫秒,代表断开2秒

3. 先通后断(点动模式)反过来,先打开,维持几秒后自动关闭。适合那种楼道感应灯或者需要短暂触发的场景:

灯亮5秒后自动熄灭

4. 状态保持(锁定功能)这个功能比较“霸道”。比如你开了灯,但不管谁手动去关,灯都会在3秒后强制再打开:

keep:1 代表锁定开,revert:3 是别人关掉后3秒恢复

四、动手撸代码(示例)

理论说完了,直接上代码。这里用最常见的 cURL (命令行)和 Python 演示,让大家直观感受下。

1. 使用cURL(适合直接测试)

先得算签名(别怕,就是把AppSecret和时间戳混在一起MD5一下),命令如下

2. 使用Python(适合嵌入业务逻辑)

在后台脚本里集成很方便

运行这段代码,灯就应该“啪”一下亮了,前后延时大约100毫秒左右,反应非常快

五、避坑指南

实践中有几个小细节值得留意:

  1. 签名别算错:这是唯一容易卡壳的地方。顺序是:先把 AppSecret 做一次32位小写MD5,得到的结果拼接上时间戳 ts(字符串直接连),再把整个新字符串做一次MD5

  2. 时间戳同步ts秒级时间戳(10位数)。服务器会校对这个时间,如果你的系统时间和真实时间差太多,会报签名过期。

  3. 本地局域网控制:如果不想走云端,芯步也支持局域网或私有化部署。把请求地址换成设备内网的API地址就行,适合工厂或内网环境

总结

就这么几步:拿钥匙(AppId)→ 找对门(设备ID)→ 喊口令(Order命令)。不论你是用手机App、PC软件、还是网页,只要通过HTTP调用这个接口,就能远程操控电源开关了。这不仅限照明,接个热水器、电风扇也完全一样,一通百通。