芯步的25A智能空开开放了标准HTTP接口,你只需要往接口POST一条JSON指令就能实现远程通断,整个过程十分钟左右就能调通。
1. 准备工作:认识一下我们的“主角”
首先,咱们得把设备和“钥匙”准备好。
1.1 硬件:25A智能空开
产品型号:UNI-DLQ-25A 。
核心能力:这家伙装在配电箱里,长得跟普通空开差不多,但它带了WiFi或4G联网功能。只要你给它发指令,它就能“咔嚓”一声实现通断。
适用场景:控制大功率设备,额定25A,阻性负载可达5000W 。
1.2 软件:拿好你的“身份证”
在动手敲代码之前,你需要登录芯步的控制台,拿到两样东西:
AppID:你的应用ID。
AppSecret:你的应用密钥(注意保密,别泄露)。
这两样东西在你注册并创建应用后,在“开发设置”里就能看到 。
1.3 设备ID
拿到钥匙后,还需要知道你要开哪把锁。在控制台的设备列表里,找到你要控制的那个25A空开,复制它的 Device ID(设备ID)。
2. 核心流程:如何发指令
对接的核心其实就是一个 HTTP 请求。这就像你平时上网填表单一样,把数据发过去就行。
接口地址https://api.thingboot.com/{你的AppID}/device/control/
请求方式:POST
数据格式:JSON
核心参数
| 参数 | 含义 | 举例 |
|---|---|---|
| device | 你要控制的设备ID | "88612345" |
| order | 你要下的命令 | {"power": 1} (合闸通电) / {"power": 0} (分闸断电) |
这里有个小细节,25A智能空开主要是控制 power 线路。如果你买的是多路的控制器,那可能就是 power1、power2。
3. 实战演练:两种控制模式
下面咱们直接上代码示例,稍微口语化一点解释。
3.1 基础控制:直接通断
这个最简单,就像按开关一样。
需求:下午3点,我想把办公室的总闸给拉了(如果是远程控制设备,就是断电)。命令:把 order 里的 power 设为 0。
请求体(Body)
3.2 高级玩法:定时与临时任务
有时候我们不需要一直开着,比如只想让它通电1分钟然后自动关。这时候可以用 reset 或 point 命令 。
reset:先接通,保持一段时间后断开(类似按了重启)。
point:先断开,保持一段时间后接通(类似按了启动,然后又关掉)。
需求:想让鱼缸水泵换水,通电3秒后自动关闭,避免忘记关。命令:使用 point(先断后通),时间单位是毫秒(毫秒)。
4. 安全签名:怎么拼Header
为了让服务器识别是你本人在操作,需要对请求进行签名。芯步的签名算法很简单,用MD5即可 。
签名公式sign = md5( md5(AppSecret) + ts )
步骤拆解
把你手上的
AppSecret(密钥)做一次 MD5 加密。拿加密后的结果,拼接上当前的时间戳
ts(比如 1699312345)。把拼接好的字符串再做一次 MD5 加密,拿到的值就是
sign。
举个例子(伪代码):
最后,把算出来的 sign 和 ts 一并在URL上提交即可 。
5. 接口调用示例
这里用最直观的 cURL 命令给大家看一眼,如果你用的是PHP、Python、Go,逻辑完全一样,无非是发个HTTP请求 。
6. 总结
总得来说,对接芯步的25A空开,体验是相当丝滑的,用他们的话说就是“十分钟完成对接”。
几个要注意的点
网络:25A空开一般是连接2.4G WiFi的,如果现场信号不好,记得选带4G版的型号