芯步的8路智能控制器提供标准HTTP API接口,单路、批量、时序控制命令都有明确格式。以下方案涵盖前期准备、签名算法、核心命令示例(含PHP/小程序代码),以及安规注意事项——你团队的前后端可直接参考对接。
1. 产品概述与接口优势
芯步推出的 8路智能分体远程电源控制箱(型号:UNI-KZQ-TY-8)是一款高集成度的远程电源管理设备。它支持通过标准 HTTP/HTTPS API 进行控制,具有体积小、负载能力强(单路最大2200W阻性负载)的特点。
核心接口优势:
协议通用性:基于 HTTP 协议,JSON 数据格式,支持任何现代编程语言(Java, Python, PHP, Node.js)及物联网平台对接。
响应迅速:实测命令下发到设备执行响应约 80-120ms。
双网融合:同时支持 公网(Remote) 和 局域网(LAN) 控制。即使外网断开,只要在同一局域网下,依然可以通过内网 IP 进行控制,保障了业务的稳定性。
2. 对接前期准备
在开发之前,请完成以下账户及环境配置:
注册与登录:访问芯步官网注册企业/开发者账号。
创建实例:在工作台创建新的应用实例,系统将自动分配 AppID 和 AppSecret(开发者密码)。
设备配网
将控制箱通电,确保其处于配网模式(指示灯快闪)。
通过“芯步”小程序或控制台,为设备配置现场的 2.4GHz WiFi 网络。
记录下设备列表中生成的 Device ID(设备唯一标识)。
3. API 调用核心逻辑:签名机制
为了安全,所有开放接口均需携带签名(Sign)。具体算法如下(以 Bash/PHP 伪代码为例):
获取当前时间戳(秒级)
ts。将
AppSecret进行一次 MD5 加密:step1 = md5(AppSecret)。拼接
step1与tsstep2 = step1 + ts。对
step2再次进行 MD5 加密得到最终签名:sign = md5(step2)。
请求地址结构:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
4. 远程指令控制详解(JSON 命令集)
芯步的接口通过 order 参数中的 JSON 字符串来执行具体动作。以下是针对该 8 路控制箱的实用命令示例。
4.1 单路独立控制
最常用的场景,单独控制某一路的“开”或“关”。
| 动作 | order 参数值 |
|---|---|
| 打开第1路 | {"power1":1} |
| 关闭第1路 | {"power1":0} |
| 打开第8路 | {"power8":1} |
引用示例:
4.2 批量多路控制
当需要一键开启或关闭多个回路时,使用 batch 命令可以大幅减少网络请求次数。
全开所有回路
{"batch":{"power":1}}全关所有回路
{"batch":{"power":0}}仅开启奇数路(1,3,5,7)
{"batch":{"relay":[1,3,5,7],"power":1}}仅关闭偶数路(2,4,6,8)
{"batch":{"relay":[2,4,6,8],"power":0}}
4.3 时序控制(Point / Reset)
在某些工业场景下(如机柜服务器重启),需要先断开再接通,中间有时间间隔。可以使用 “先通后断” 或 “先断后通” 指令。
顺序通电(point):按照指定顺序依次接通线路。
示例:对线路2、4、6、8依次通电,每个间隔1秒
{"point":{"relay":[2,4,6,8],"interval":1000}}
顺序断电(reset):按照指定顺序依次断开线路。
示例:对所有线路依次断电,间隔500毫秒
{"reset":{"interval":500}}
5. 实战代码示例
以下是基于 PHP(适用于后端集成)和 微信小程序(适用于移动端)的对接实例。
5.1 PHP 后端对接示例
代码逻辑参考自芯步开放接口规范
5.2 微信小程序对接示例
适用于管理员在移动端远程运维。
代码逻辑参考微信小程序 API 调用规范
6. 高级集成:本地局域网控制
对于不允许连接外网的保密环境或对延时要求比较高的场景,芯步设备支持局域网控制功能。
如果在物联网控制台中为该设备分配了固定 IP,或者你知晓其在局域网内的 IP 地址,可以直接将上述请求中的域名 api.thingboot.com 替换为该设备的 局域网 IP 地址。
注意:局域网模式下仍需携带 AppId, sign, ts 参数进行身份验证,但数据流量不经过云端,直接发往设备,极大提升了内网吞吐下的稳定性和响应速度。
7. 安规与负载注意事项
在进行物理接线和软件控制逻辑设计时,请请一定要遵守以下电气特性,以避免损坏设备或触发保护:
负载类型区分
阻性负载(白炽灯、电热丝):单路最大 2200W。
感性/容性负载(LED灯、电机、节能灯):单路最大 350W。因为启动电流瞬时较大,需预留余量。
总功率上限:整机全接通时,总负载不得超过 4400W(阻性负载) 或 700W(感性负载)。
工作电压:该型号支持 DC 12V 1.5A 供电,接口协议同样适用于交流 85-265V 的交流版本,请根据铭牌选择电源。
8. 总结
通过对接芯步标准的 HTTP 开放接口,开发者可以在短时间内为 8 路远程电源控制箱构建定制化的管理系统。从单路的独立控制到复杂的批量时序动作,接口均提供了清晰的支持。无论是将其集成到现有的楼宇自控系统中,还是开发独立的微信小程序进行便携管理,该方案都具备比较高的可靠性和灵活性。