芯步的40A数显智能空开支持HTTP接口远程控制,单次最多可同时控制100台设备。下面按“获取凭证→设备上云→接口调用→批量管理”的顺序,讲清楚整套对接流程。
一、 准备工作:拿到你的“开发钥匙”
在写代码之前,需要先到芯步的后台拿到几个关键凭证,这就好比是进门的钥匙。
注册与登录:去芯步官网注册一个账号。
找到密钥:登录后,进入“物联网控制台”,在“开发设置”里找到你的
AppID和AppSecret。AppID:是你的身份标识。
AppSecret:是你的密码,千万不要把它写在网页前端的代码里,最好放在后端服务中。
理解签名算法:芯步的接口为了安全,每次请求都需要带一个签名。算法一般是:
sign = md5( md5(AppSecret) + ts )。简单说就是把你的密钥进行一次MD5加密,再结合当前的时间戳,再算一次MD5。
二、 设备“上云”:让空开连上网络
拿到钥匙后,要让硬件通网。这批40A空开用的是 WiFi 通讯(支持2.4G频段),不需要额外买网关。
通电:按照说明书接好线,给空开通电。
配网:有两种方式,推荐用小程序。
小程序配网:微信搜索“芯步”小程序,登录你的账号,点击“添加设备”。这时候按提示输入你场地的WiFi密码,对着空开点一下配网就行。
控制台配网:你也可以在电脑网页端的“物联网控制台” -> “网络配置”里操作。
确认上线:配网成功后,在控制台的“设备列表”里,你会看到这个设备的状态变成了“在线”,并且能拿到一个核心数据——设备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个教室,你想一键开启“放学模式”全部断电。
打标签:在后台把这20个设备打上一个标签叫“教室组”或“Building_A”,会生成一个标签ID。
发指令:以后你要关这一组,只需对着标签ID发指令,不需要知道里面具体有哪些设备了。
这样效率最高,管理起来也最清晰。
进阶技巧:延时与定时除了简单的开/关,接口还支持一些高级参数。
临时定时:比如你想在关掉某台机器1小时后自动重启(常用于广告机或制冷设备),可以在指令里加参数:
{"power":0,"reset":3600000},这就表示关了之后,3600000毫秒(1小时)后自动再打开。
五、 避坑指南与配置
1. 网络延时与反馈机制接口返回code 200只代表平台收到了指令,不代表空开已经执行了动作(比如设备这时候刚好掉线了)。:如果你需要确认空开真的动作了,可以启用平台的“异步消息推送”功能,或者发出指令后延时2秒再去查询一次设备状态来核对。
2. 私有化部署如果你的客户对数据安全要求比较高,比如政府机房或者数据中心,芯步这套方案是支持局域网和私有化部署的。你可以把整个控制逻辑跑在客户自己的服务器上,不经过外网。
3. 呼叫技术支持芯步官方提供免费的技术指导。如果你在对接签名算法那一步遇到难题(Python、Java、Go等语言的签名细节不太一样),或者连不上网,可以直接找他们的工程师协助调试。
总结:对接流程梳理
注册账号:获取
AppID和AppSecret。配网:通电图,使用小程序将空开连上WiFi,拿到
设备ID。打标签:在后台上把同一区域的设备分到一个标签组里。
写代码:在你的工单系统或能耗系统里,调用HTTP接口
device/control或tag/control,带上签名和命令。
通过这几步,就可以把40A的智能空开集成到你自己的系统里,实现对整栋楼或者整个园区的精细化用电管理了。