CATALOG

AC1-10A这款智能开关的核心价值在于:你完全不用关心它底层的WiFi配网、信号维护这些破事儿,只需要对着它的“云大脑”发个HTTP请求就完事了。下面说说具体怎么接。

一、 准备工作:先把“三件套”备齐

动手前,先把下面这三样东西准备好,免得干活时手忙脚乱

  1. 硬件本体:就是咱们的AC1-10A智能开关。记得给它通上电,然后拿起手机,用微信小程序(搜“芯步”)给它连上你家的2.4G WiFi。这一步跟咱们新买路由器配置差不多,照着提示点就行了。

  2. 开发者后台的三把钥匙:登录芯步的官网后台,找到“开发设置”。这里面有三个关键字符串,你可得藏好:

    • AppID:相当于你的“账号”,告诉服务器你是谁。

    • AppSecret:相当于你的“密码”,用来加密签名,千万别把它直接写在网页代码里。

    • 设备ID:就是你手里那个开关的“身份证号”,在后台的设备列表里一眼就能看到

  3. 网络环境:只要你的服务器能上网,就能控制它,不分什么内网外网。

二、 核心原理:其实就是在“发短信”

你不需要搞懂复杂的电路协议,只需要理解一件事:你写代码给芯步的服务器发个指令,服务器转手就下发给你家那个开关

这里唯一稍微绕一点的就是签名。你可以把它理解为你的“电子指纹”。芯步的服务器为了安全,不接收明文密码(AppSecret),而是让你把当前时间戳和密码混合一下,做一个MD5加密。这样每次请求的签名都不一样,就算被人截获了,他也无法长期冒充你的身份

签名的算法很简单,伪代码如下:

  • step1 = MD5(你的AppSecret)

  • step2 = MD5(step1 + 当前的时间戳)

  • 最后这个 step2 就是你要带上的 sign

三、 动手写代码:这么控制这台开关

其实不管你是用Python做后端,还是用JavaScript写网页,甚至是用PHP、Java,套路都是一样的。这里咱们就拿万能的cURL命令,或者最顺手的Python来举例。

目标:把连着开关的灯打开(或者电饭煲启动)。

1. 构造请求地址地址格式是固定的,你需要把{}里的内容替换成你自己的https://api.thingboot.com/{你的AppID}/device/control/?sign={计算出的签名}&ts={当前时间戳}

2. 构造要发送的Body内容我们需要告诉服务器两件事:控制谁(设备ID),以及控制啥(命令)

  • device:填你那个开关的ID,比如 123456789

  • order:AC1-10A的命令其实特别简单,{"power": "1"} 就是开,{"power": "0"} 就是关。

3. 完整实战(Python 示例)

假设你要远程关闭正在充电的电动车(场景满分),代码大概长这样。这里我把鉴权细节都封装好了,看着更清晰:

4. 看一眼返回结果如果一切顺利,服务器会给你回一句:

这就代表指令已经成功发出去了。这时候你应该就能听见开关“咔哒”一声轻响,这就对接成功了

四、 进阶操作:玩点心跳

如果只是简单的开和关,那太对不起这硬件了。AC1-10A还支持“定时通断”或“点动模式”。比如你要控制一个门禁锁,按下按钮开锁,2秒后自动又锁上。这时候就不需要写定时器去关,直接发下面这个命令就行:

五、 写在最后的贴心提示

  1. 关于调试:刚开始测试的时候,如果不想每次都要手动算签名,可以去后台把“调试模式”打开。在这个模式下,你可以暂时忽略签名验证,先用Postman之类的工具把命令调通,再回过头去封装代码,可以省不少事

  2. 关于安全:一定不要把 AppSecret 写在前端代码里(比如小程序或JS里),很容易被人扒走。正确的做法是,让后端服务器去控制,前端只负责调用你自己的后端接口。

  3. 关于反馈:如果有需要,你也可以设置一个回调URL。这样,每当设备状态变了(比如你手动按了一下开关),芯步的服务器会主动通知你的服务器。不过,对于刚开始的你来说,先搞定上面那个HTTP请求,就已经能解决80%的问题了。

这套方案上手快,稳定性也不错,希望对你有帮助~