CATALOG

针对芯步的40A带计量数显物联网断路器,你可以通过调用其开放的HTTP API接口,在你自己的软件系统中实现远程通断控制。整个对接流程可以概括为:获取凭证 → 找到设备 → 下发指令

下面我会一步步把“怎么接”这件事拆开来讲。

第一步:准备工作(拿到“钥匙”和“门牌号”)

在写代码之前,你需要先登录芯步的控制台,拿到两样东西,这就像进门前要配钥匙和看门牌号:

  1. AppID 和 AppSecret(你的“账号和密码”):这俩是你调用接口的身份凭证。AppID 往往是明文传输的,而 AppSecret 是用来生成签名(Sign)的,千万别把它写在客户端的代码里,一定要放在后端服务中,否则会有安全风险

  2. Device ID(你家断路器的“门牌号”):在控制台的设备列表里,找到你那个 40A 的断路器,复制下它的 Device ID。这是你告诉系统“我要控制哪个设备”的关键

  3. 确认指令格式:对于这款断路器,远程通断控制通常用的是 power 指令。power=1 代表“通”(合闸),power=0 代表“断”(分闸)

第二步:核心逻辑(防坑指南:签名计算)

为了防止接口被别人恶意调用,芯步要求在请求的时候带上一个动态生成的签名(Sign)和时间戳(Ts)。这是新手比较容易踩坑的地方,你可以这样理解生成规则:

Sign = md5( md5(AppSecret) + Ts )

  • Ts:当前时间的 Unix 时间戳(秒级),是一个10位的数字。

  • 注意:是先把 AppSecret 做一次 MD5 加密(得到32位小写字符串),然后拿着这个结果去跟 Ts 拼接,拼接后再做一次 MD5 加密

第三步:实操对接(两种方式,按需选择)

你既可以操作单个设备,也可以批量控制一组设备

方式一:单刀直入(控制单个设备)

如果你只需要控制这一个断路器,就用这个接口。它是直来直去的,最适合快速调试

  • 接口地址http(s)://api.thingboot.com/{你的AppID}/device/control/

  • 请求方法:推荐用 POST

  • 请求参数(Body里的JSON)

  • 实际效果:如果返回 {"code":200},代表平台已经收到了指令并下发给设备了。如果设备在线,几秒钟之内就会跳闸或合闸。

方式二:一网打尽(控制一组设备)

如果你装了多台断路器,想一键关闭所有空调电源,可以先把它们加入同一个“分组”,通过操作分组来批量控制

  • 接口地址http(s)://api.thingboot.com/{你的AppID}/group/control/

  • 请求参数

第四步:进阶玩法(不只是开关)

既然接都接了,光开关就太浪费了。既然这款断路器带计量和数显,那它的价值在于数据。你完全可以把数据读出来,做能耗分析

  1. 实时功率监测:通过相应的查询接口,你可以读到当前的电压、电流、功率。这在做节能策略时非常有用。

  2. 定时任务与联动:别只用手动点按钮。比如你可以写个定时脚本(Cron Job),每天晚上 11 点自动把 power=0 发过去,关掉广告牌电源。或者根据读取到的功率值做逻辑判断——比如空调待机功率低于 10W 超过 10 分钟,自动断电。

第五步:本地化部署(追求极致稳定)

如果你是在工厂、机房这种核心场景使用,对外网断流比较敏感,不用担心。这款设备支持局域网通信。你可以把整个控制逻辑部署在本地服务器上,不经过芯步的云端,这样即便外网断了,你的“远程控制”功能在局域网内部依然是可用的

总结一下

一句话总结:在你的服务器后端,用 AppSecret 和当前时间戳算出 Sign,然后直接向芯步的 device/control 接口发送一个包含 Device IDpower=0/1 指令的 POST 请求。

这个过程有点像是发一条加密的短信给电闸。如果你卡在签名(Sign)计算这一关,记得检查一下是 md5(md5(secret)+ts) 这个顺序,这是绝大多数问题的根源