芯步16A智能插座采用HTTP接口开放策略,从设备配网到接口调用均可自主完成。以下方案涵盖两种型号(桌面款/86型)的接入流程,重点说明签名算法和控制指令的构造方法。
解决方案:基于芯步开放接口实现16A智能插座远程控制
1. 适用产品与准备工作
在开始开发前,请确认你拥有以下硬件及账号权限。芯步的16A插座主要分为两类,接口协议一致,但安装方式不同
| 设备类型 | 产品型号示例 | 特点 | 适用场景 |
|---|---|---|---|
| 桌面型智能插座16A | UNI-CZ-16A-P | 即插即用,3PIN插头,体积小巧 | 大1匹空调、热水器等即插即用设备 |
| 墙壁型智能插座16A | UNI-QC-16A | 标准86型底盒,需替换原有墙壁插座 | 中央空调、2匹内空调、隐藏式安装 |
准备工作清单:
硬件:确保家庭WiFi网络为2.4GHz频段(物联网设备通常不支持5G频段),插座通电。
账号:注册芯步开发者账号,登录控制台。
密钥:在控制台的“开发设置”中获取
AppId(应用ID)和AppSecret(开发者密码)。
2. 设备配网:让插座连接互联网
在通过API控制之前,需要先将插座连接到你的WiFi网络。推荐使用以下两种方式:
方式A:小程序配网(推荐)
微信搜索“芯步”小程序。
登录你的账号,点击“添加设备”或“网络配置”。
输入当前的WiFi名称和密码(仅支持2.4G)。
长按插座上的按钮(或根据产品手册),直到指示灯进入快闪模式(配网状态)。
小程序会自动发现设备并完成配网。
方式B:控制台配网在PC端登录物联网控制台,进入“网络配置”页面,登记WiFi信息后,通过手机热点辅助完成设备配置。
配网验证:配网成功后,在控制台的“设备列表”中可以看到新设备的唯一标识——Device ID(如:820720),这是后续API操作的关键凭证。
3. 接口鉴权与签名生成
芯步的API使用动态签名进行安全校验。所有HTTP请求都需要在URL中携带签名参数。
请求地址示例:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
签名算法步骤:为防止接口被篡改,需要按以下逻辑生成 sign
将你的
AppSecret进行一次 MD5加密,得到字符串S1。拼接
S1与 当前Unix时间戳(秒)ts,得到字符串S2。将
S2再次进行MD5加密,得到最终的sign。
*公式说明:sign = MD5( MD5(AppSecret) + ts )*
代码示例(Node.js):
4. 实现远程“开/关”控制
拿到签名和设备ID后,即可通过POST请求下发指令。
接口URL
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法:POST
Content-Type
application/json
核心命令格式:
开启电源:发送
{"power": 1}关闭电源:发送
{"power": 0}
请求Body示例(JSON):
场景扩展:定时控制如果你希望插座在打开后自动关闭(例如控制热水器),无需在业务层设置定时任务,可以直接下发延时指令
先通后断
{"point": 3600000}(打开电源,1小时后自动关闭,单位毫秒)先断后通
{"reset": 300000}(关闭电源,5分钟后自动重启,适用于路由器重启等场景)
5. 开发集成示例(Shell + cURL)
以下是一个完整的Shell脚本示例,展示了如何在Linux环境下快速控制插座
*响应时间通常为 80-120ms,延迟极低。*
6. 高级应用:数据监控与私有化部署
功率计量(仅计量版支持):如果你购买的是带“-P”后缀的计量版插座,设备会主动上报电压、电流、功率等信息。你可以通过配置“消息推送”或轮询设备状态接口,将用电数据接入你的业务系统,实现用电量统计和过载预警。
私有化部署:对于注重数据安全的企业(如工厂、实验室),芯步支持私有化部署。你可以将API切换到局域网IP(纯内网环境运行),或者自建MQTT/HTTP服务器接收数据,所有数据无需经过芯步的公有云。
总结
通过上述步骤,你可以在 10分钟 内完成从配网到接口调用的全过程。关键点在于正确生成 MD5嵌套签名,以及掌握 power 和 point 等多个命令的运用。这套方案不仅适用于简单的开关控制,还可以集成进现有的ERP、HomeAssistant或企业内部SaaS系统中。