CATALOG

芯步16A智能插座采用HTTP接口开放策略,从设备配网到接口调用均可自主完成。以下方案涵盖两种型号(桌面款/86型)的接入流程,重点说明签名算法和控制指令的构造方法。

解决方案:基于芯步开放接口实现16A智能插座远程控制

1. 适用产品与准备工作

在开始开发前,请确认你拥有以下硬件及账号权限。芯步的16A插座主要分为两类,接口协议一致,但安装方式不同

设备类型产品型号示例特点适用场景
桌面型智能插座16AUNI-CZ-16A-P即插即用,3PIN插头,体积小巧大1匹空调、热水器等即插即用设备
墙壁型智能插座16AUNI-QC-16A标准86型底盒,需替换原有墙壁插座中央空调、2匹内空调、隐藏式安装

准备工作清单:

  • 硬件:确保家庭WiFi网络为2.4GHz频段(物联网设备通常不支持5G频段),插座通电

  • 账号:注册芯步开发者账号,登录控制台。

  • 密钥:在控制台的“开发设置”中获取 AppId(应用ID)和 AppSecret(开发者密码)。

2. 设备配网:让插座连接互联网

在通过API控制之前,需要先将插座连接到你的WiFi网络。推荐使用以下两种方式:

  • 方式A:小程序配网(推荐)

    1. 微信搜索“芯步”小程序。

    2. 登录你的账号,点击“添加设备”或“网络配置”。

    3. 输入当前的WiFi名称和密码(仅支持2.4G)。

    4. 长按插座上的按钮(或根据产品手册),直到指示灯进入快闪模式(配网状态)。

    5. 小程序会自动发现设备并完成配网

  • 方式B:控制台配网在PC端登录物联网控制台,进入“网络配置”页面,登记WiFi信息后,通过手机热点辅助完成设备配置

配网验证:配网成功后,在控制台的“设备列表”中可以看到新设备的唯一标识——Device ID(如:820720),这是后续API操作的关键凭证

3. 接口鉴权与签名生成

芯步的API使用动态签名进行安全校验。所有HTTP请求都需要在URL中携带签名参数。

请求地址示例:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名算法步骤:为防止接口被篡改,需要按以下逻辑生成 sign

  1. 将你的 AppSecret 进行一次 MD5加密,得到字符串 S1

  2. 拼接 S1当前Unix时间戳(秒)ts,得到字符串 S2

  3. S2 再次进行MD5加密,得到最终的 sign

*公式说明:sign = MD5( MD5(AppSecret) + ts )*

代码示例(Node.js):

4. 实现远程“开/关”控制

拿到签名和设备ID后,即可通过POST请求下发指令。

  • 接口URLhttps://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方法:POST

  • Content-Typeapplication/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嵌套签名,以及掌握 powerpoint 等多个命令的运用。这套方案不仅适用于简单的开关控制,还可以集成进现有的ERP、HomeAssistant或企业内部SaaS系统中

插座产品方案:
园区设备电源控制:如何将1位5孔定时开关插座接入到软件项目中
查看 >>
办公室插座回路保护:怎么将带计量智能断路器50A对接到自己的项目中
查看 >>
写字楼设备电源管理:怎么把16A86型定时智能插座接入到软件项目中
查看 >>
办公室设备电源控制:怎么把1位5孔单路智能插座对接到软件项目中
查看 >>
如何接入16A 3孔国标智能插座来实现设备运行状态监控
查看 >>
电器场景方案:
怎样对接16A远程电源控制插座来实现远程控制电器电源
查看 >>
如何在智能办公中集成智能设备来实现远程打开关闭大功率电器电源
查看 >>
怎样在智能家居电器控制中对接智能设备来实现设备分组控制
查看 >>
智能家居多路电器控制:如何把24 路智能分体远程电源控制器集成到软件项目中
查看 >>
咖啡厅电器回路保护:怎么将AC1-10A 定时控制开关接入到自己的项目中
查看 >>
关闭用途方案:
如何二次开发触摸式出门按钮以实现远程打开关闭门禁
查看 >>
怎么二次开发16A空调智能插座来实现远程打开关闭电器电源
查看 >>
怎么在广告机设备机柜电源管理中接入智能设备以实现远程打开关闭8路设备电源
查看 >>
怎样对接智能插座16A以实现远程打开关闭电器电源
查看 >>
怎样在设备运维机柜远程电源管理中对接智能硬件来实现远程打开关闭8路设备电源
查看 >>