CATALOG

芯步的25A智能空开开放了标准HTTP接口,你只需要往接口POST一条JSON指令就能实现远程通断,整个过程十分钟左右就能调通。

1. 准备工作:认识一下我们的“主角”

首先,咱们得把设备和“钥匙”准备好。

1.1 硬件:25A智能空开

  • 产品型号:UNI-DLQ-25A

  • 核心能力:这家伙装在配电箱里,长得跟普通空开差不多,但它带了WiFi或4G联网功能。只要你给它发指令,它就能“咔嚓”一声实现通断。

  • 适用场景:控制大功率设备,额定25A,阻性负载可达5000W

1.2 软件:拿好你的“身份证”

在动手敲代码之前,你需要登录芯步的控制台,拿到两样东西:

  1. AppID:你的应用ID。

  2. 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 线路。如果你买的是多路的控制器,那可能就是 power1power2

3. 实战演练:两种控制模式

下面咱们直接上代码示例,稍微口语化一点解释。

3.1 基础控制:直接通断

这个最简单,就像按开关一样。

需求:下午3点,我想把办公室的总闸给拉了(如果是远程控制设备,就是断电)。命令:把 order 里的 power 设为 0

请求体(Body)

3.2 高级玩法:定时与临时任务

有时候我们不需要一直开着,比如只想让它通电1分钟然后自动关。这时候可以用 resetpoint 命令

  • reset:先接通,保持一段时间后断开(类似按了重启)。

  • point:先断开,保持一段时间后接通(类似按了启动,然后又关掉)。

需求:想让鱼缸水泵换水,通电3秒后自动关闭,避免忘记关。命令:使用 point(先断后通),时间单位是毫秒(毫秒)。

4. 安全签名:怎么拼Header

为了让服务器识别是你本人在操作,需要对请求进行签名。芯步的签名算法很简单,用MD5即可

签名公式sign = md5( md5(AppSecret) + ts )

步骤拆解

  1. 把你手上的 AppSecret(密钥)做一次 MD5 加密

  2. 拿加密后的结果,拼接上当前的时间戳 ts(比如 1699312345)。

  3. 把拼接好的字符串再做一次 MD5 加密,拿到的值就是 sign

举个例子(伪代码):

最后,把算出来的 signts 一并在URL上提交即可

5. 接口调用示例

这里用最直观的 cURL 命令给大家看一眼,如果你用的是PHP、Python、Go,逻辑完全一样,无非是发个HTTP请求

6. 总结

总得来说,对接芯步的25A空开,体验是相当丝滑的,用他们的话说就是“十分钟完成对接”

几个要注意的点

  1. 网络:25A空开一般是连接2.4G WiFi的,如果现场信号不好,记得选带4G版的型号