CATALOG

芯步的10A智能插座支持HTTP API远程控制,签名机制是双层MD5加密,接口响应约80-120ms。以下方案涵盖硬件选型、API接入、代码实现及典型场景应用。

1. 背景与需求分析

在小型商铺(如便利店、奶茶店、快餐店、自助健身房)的运营中,电力管理往往存在痛点:员工下班忘记关灯关设备、空调长期运行浪费电、无法远程监控设备状态导致安全隐患。本项目目标:利用芯步的 10A 86型WiFi智能墙壁插座,通过标准的HTTP API接口,将商铺内的单个高功率设备(如咖啡机、热水器、冰柜、招牌灯箱)无缝接入现有的管理后台或手机应用中,实现远程控制、定时开关和能耗监测。

2. 硬件选型与参数

根据商铺环境,我们选择 UNI-QC-10A-P(带功率计量版) 型号。

  • 安装标准:直接替换传统的86型墙壁插座,无需额外布线,保持墙面整洁

  • 电气参数:额定电流10A,最大负载2200W。适用于小型商铺的咖啡机(通常1200W-1800W)、微波炉、电饭煲等设备。

  • 核心优势

    • 实时计量:可实时上报电压、电流、功率,方便商户进行能耗统计或设备故障预警(如功率异常升高)

    • 联网方式:支持2.4GHz WiFi,覆盖范围广,配置简单

3. 整体设计

系统的集成架构分为三层:

  1. 设备层:部署在各个商位的86型WiFi插座。每个插座独立运行,通过WiFi连接至云端。

  2. 云平台层:芯步云平台。负责设备连接、状态保持、指令转发和签名验证。平台开放了HTTP API供业务侧调用

  3. 应用层(你的项目):包括商户端APP、管理后台Web端或自动化脚本。通过调用API实现控制逻辑。

4. 详细开发接入步骤

4.1 前期准备与设备配网

  • 注册与创建:在芯步官方注册企业/个人账号,进入控制台创建“工作台”。获取核心凭证:AppIDAppSecret

  • 设备配网:在商铺现场,安装插座并通电。使用微信小程序(芯步)或PC控制台,通过“网络配置”功能将插座加入到店铺的2.4G WiFi网络中

  • 获取设备ID:配网成功后,在控制台设备列表中获取该插座的唯一标识 Device ID

4.2 核心接口签名机制

芯步的API安全性采用动态签名机制,所有控制请求必须携带动态生成的sign参数。这是接入最关键的环节,请一定要在后端服务中实现,避免将AppSecret暴露给前端

签名算法逻辑(伪代码)

  1. AppSecret 进行一次MD5加密得到 Secret_MD5

  2. 获取当前Unix时间戳(秒级)ts

  3. Secret_MD5ts 拼接成字符串 Temp_Str

  4. Temp_Str 再次进行MD5加密,得到最终的 Sign

公式Sign = MD5( MD5(AppSecret) + ts )

4.3 接口调用实战

使用标准HTTP POST请求调用控制接口。芯步开放接口支持跨平台,无论是Python、Java、PHP还是Node.js均可轻松接入

  • 请求地址https://api.thingboot.com/{AppID}/device/control/

  • URL参数sign={计算出的签名}&ts={时间戳}

  • 请求头Content-Type: application/json

  • 请求体(Body)

    注:{"power": 1} 代表开启两个插孔的总电源;{"power": 0} 代表关闭;对于带计量设备,还可通过状态查询接口获取功率数据

4.4 代码示例(以Python和Node.js为例)

Python 实现示例你可以将以下代码封装在商铺管理系统的后端服务中:

Node.js 实现示例如果项目是基于JavaScript的全栈开发,可以使用以下脚本

4.5 高级功能集成(功率联动)

由于选择了带计量版插座,你可以开发更智能的联动逻辑,而不仅仅是简单的开关

  • 无人自动断电:利用功率计量接口,如果检测到功率为0(设备待机或关闭)且店铺处于打烊状态,自动切断电源,消除火灾隐患。

  • 设备故障预警:当监测到冰柜的实时功率突然降为0(断电)时,系统自动向店主推送报警通知。

5. 项目落地中的注意事项

  1. 负载匹配:虽然插座支持2200W,但针对感性负载(如带电机的冰箱、排气扇),降额使用(不超过300W),否则可能因浪涌电流导致触点粘连

  2. 网络稳定性:商铺的WiFi路由器需保持稳定。插座断网后会保持断网前的状态(如保持开启),但无法接收新指令。为路由器配置自动重启计划。

  3. 局域网控制(可选):如果项目对响应速度要求比较高(如流水线工位),芯步也支持局域网HTTP API控制,可以不经过外网直接在本地发送指令,延迟可降至10ms以内

  4. 调试模式:在开发测试阶段,可以在后台“开发设置”中开启“调试模式”,此时不校验签名,方便快速验证业务逻辑。上线前请一定要关闭

6. 总结

将芯步的10A WiFi智能插座接入项目管理中,本质上是一个“HTTP请求调用”的过程。通过上述方案,我们实现了:

  1. 硬件无损替换:86型直接换装,适合已装修商铺。

  2. 双保险控制:既保留了物理按键操作,又打通了云端API。

  3. 运维透明化:从单纯的“用电”变成了“控电”与“看电”。

借助芯步开放的接口,即使是中小型技术团队,也能在 1天内 完成从设备配网到后台控制功能的完整开发,让商铺的能源管理迈入数字化。