CATALOG

芯步的40A数显智能空开支持HTTP接口远程控制,单次最多可同时控制100台设备。下面按“获取凭证→设备上云→接口调用→批量管理”的顺序,讲清楚整套对接流程。

一、 准备工作:拿到你的“开发钥匙”

在写代码之前,需要先到芯步的后台拿到几个关键凭证,这就好比是进门的钥匙。

  1. 注册与登录:去芯步官网注册一个账号。

  2. 找到密钥:登录后,进入“物联网控制台”,在“开发设置”里找到你的 AppIDAppSecret

    • AppID:是你的身份标识。

    • AppSecret:是你的密码,千万不要把它写在网页前端的代码里,最好放在后端服务中

  3. 理解签名算法:芯步的接口为了安全,每次请求都需要带一个签名。算法一般是:sign = md5( md5(AppSecret) + ts )。简单说就是把你的密钥进行一次MD5加密,再结合当前的时间戳,再算一次MD5

二、 设备“上云”:让空开连上网络

拿到钥匙后,要让硬件通网。这批40A空开用的是 WiFi 通讯(支持2.4G频段),不需要额外买网关

  1. 通电:按照说明书接好线,给空开通电。

  2. 配网:有两种方式,推荐用小程序。

    • 小程序配网:微信搜索“芯步”小程序,登录你的账号,点击“添加设备”。这时候按提示输入你场地的WiFi密码,对着空开点一下配网就行

    • 控制台配网:你也可以在电脑网页端的“物联网控制台” -> “网络配置”里操作

  3. 确认上线:配网成功后,在控制台的“设备列表”里,你会看到这个设备的状态变成了“在线”,并且能拿到一个核心数据——设备ID(Device ID),这个ID就是你要控制的那个具体地址。

三、 接口实战:怎么发一条指令

设备上线了,接下来看看怎么用代码控制它。

接口地址http(s)://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

核心逻辑:向这个地址发送POST请求,Body里带上设备ID你要干的事(Order)

单台控制(开/关)这是最常用的,比如你要关掉其中一台设备,代码逻辑(以常见的JSON格式为例)就是这样:

你把它改成"power": 1,就是远程合闸送电了

获取实时读数你选的这款是“数显版”,这意味着你不仅能控制,还能看数据。通过查询接口,你可以拿到电压、电流、功率等实时数据,方便做能耗监控或超载预警

四、 进阶操作:如何实现“批量控制”

如果是一个楼层或者一栋楼,你肯定不想一个个去发指令,芯步接口设计了几种批量操作方式。

方式一:单接口控制多设备如果你只有三四台设备要同时控制,直接在请求里用逗号隔开设备ID就行。

注意,一次最多支持100台设备,如果是上百台的大项目,分批调用或者用下面的标签方式

方式二:使用“标签”进行分组批量控制这才是批量管理的正规军。假设你有20台空开管着20个教室,你想一键开启“放学模式”全部断电。

  1. 打标签:在后台把这20个设备打上一个标签叫“教室组”或“Building_A”,会生成一个标签ID。

  2. 发指令:以后你要关这一组,只需对着标签ID发指令,不需要知道里面具体有哪些设备了。

这样效率最高,管理起来也最清晰

进阶技巧:延时与定时除了简单的开/关,接口还支持一些高级参数。

  • 临时定时:比如你想在关掉某台机器1小时后自动重启(常用于广告机或制冷设备),可以在指令里加参数:{"power":0,"reset":3600000},这就表示关了之后,3600000毫秒(1小时)后自动再打开

五、 避坑指南与配置

1. 网络延时与反馈机制接口返回code 200只代表平台收到了指令,不代表空开已经执行了动作(比如设备这时候刚好掉线了):如果你需要确认空开真的动作了,可以启用平台的“异步消息推送”功能,或者发出指令后延时2秒再去查询一次设备状态来核对。

2. 私有化部署如果你的客户对数据安全要求比较高,比如政府机房或者数据中心,芯步这套方案是支持局域网私有化部署的。你可以把整个控制逻辑跑在客户自己的服务器上,不经过外网

3. 呼叫技术支持芯步官方提供免费的技术指导。如果你在对接签名算法那一步遇到难题(Python、Java、Go等语言的签名细节不太一样),或者连不上网,可以直接找他们的工程师协助调试

总结:对接流程梳理

  1. 注册账号:获取 AppIDAppSecret

  2. 配网:通电图,使用小程序将空开连上WiFi,拿到 设备ID

  3. 打标签:在后台上把同一区域的设备分到一个标签组里。

  4. 写代码:在你的工单系统或能耗系统里,调用HTTP接口 device/controltag/control,带上签名和命令。

通过这几步,就可以把40A的智能空开集成到你自己的系统里,实现对整栋楼或者整个园区的精细化用电管理了。