CATALOG

芯步的16A智能插座支持HTTP接口直接调用,无需网关、不挑语言,可快速集成到各类软件项目中。以下从产品选型、接口对接、代码示例到应用场景,给出完整的接入方案。

一、 产品选型与接口优势分析

在智能办公场景中,我们选择的是芯步 智能插座16A[计量版] (型号:UNI-CZ-16A-P)。在选择该设备接入软件项目时,拥有以下核心优势:

  • 高功率承载:额定电流16A,最大功率3500W,专为办公室大功率设备设计,如大型饮水机、咖啡机、一楼大厅的中央空调面板、投影设备等

  • 开放性极强:设备提供标准的 HTTP API接口。这意味着无论你的软件项目是基于 Web、Java、Python、Node.js,还是微信小程序、APP,只要有网络请求能力,都能轻松集成

  • 无需网关:设备直连WiFi 2.4G网络,部署简单,降低了私有化部署的硬件成本

  • 数据可视化:计量版支持实时读取电压、电流、功率等数据,为办公节能分析提供数据支撑

二、 整体接入架构

将16A智能插座接入软件项目的架构通常分为三层:

  1. 设备层:芯步16A智能插座,连接办公电器(如热水器、会议室空调)。

  2. 接口层:芯步官方API服务器,或通过私有化部署搭建的本地消息服务器(支持纯局域网运行)。

  3. 应用层:你的企业内部OA系统、能耗管理SaaS后台、或者是手机端APP。

交互流程软件项目 \rightarrow HTTP请求(携带签名、设备ID、开关指令)\rightarrow 芯步云/本地服务器 \rightarrow WiFi下发指令 \rightarrow 插座执行 \rightarrow 返回状态。

三、 详细接入步骤

1. 环境准备与设备配网

  • 注册与获取凭证:登录芯步控制台,获取 AppIDAPI Key(用于生成签名)。将插座添加到账号下,获取唯一的 Device ID

  • 网络配置:插座通电后,通过配网模式让其连接到办公区域的WiFi网络

2. 接口鉴权与签名机制

为防止接口被恶意调用,每次请求需携带签名。签名位于URL参数中:/sign={sign}&ts={ts}

  • ts:Unix时间戳(秒),用于防止重放攻击。

  • sign:通常是将 AppIDDevice IDts 以及 API Key 按规则拼接后取MD5值。

鉴权参数构建示例逻辑:

3. 核心API调用:远程开关与控制

接入最核心的部分是下发控制命令。根据芯步接口定义,通过POST方式向设备下发order指令。

接口地址POST /{AppID}/device/control/参数说明

  • device:设备ID(支持批量,用逗号分隔)。

  • order:JSON字符串,用于定义控制行为。

① 基础开关控制最常用的功能,直接开启或关闭插座电源。

  • 开启指令{"power":"1"}

  • 关闭指令{"power":"0"}

② 场景化高级指令(智能办公特色)这里有两个非常适合办公场景的指令:

  • 临时通电(point):适用于会议室投影幕布或需要短时通电的装置。指令让插座立即通电,持续指定毫秒后自动断电。

    • 示例{"point":"3000"} (通电3秒后关闭)

  • 临时断电(reset):适用于路由器、NAS(网络附加存储)或工控机死机后的重启。指令让插座立即断电,等待一段时间后重新恢复供电。

    • 示例{"reset":"5000"} (断电5秒后重新开启)

4. 数据采集:能耗监测

如果开启了计量功能,可通过接口查询电器的实时功耗。这在办公节能管理中非常有用,例如判断会议室空调是否在非工作时间忘记关闭

  • 典型请求:查询设备状态,返回参数中通常包含 power(当前功率)、voltage(电压)、current(电流)。

四、 代码接入示例

针对不同的软件开发项目,接入方式如下所示:

示例1:Java (适用于后端服务或OA系统)

使用OkHttp3库调用API关闭插座

示例2:Node.js (适用于小程序云函数或前端)

五、 典型办公场景应用方案

第一种场景:会议室自动化

  • 痛点:会议结束后,投影仪、空调、新风系统常被忽略关闭。

  • 解决方案:将16A插座接入会议室中控屏或OA的会议预定系统

    • 逻辑:会议预定时间结束 → OA系统触发 → 调用API发送 {"power":"0"} → 会议室强制断电。

    • 注意:如使用空调等设备,配合红外遥控器,或直接断电对设备影响较大,仅用于非精密电器或推送提醒后执行。

第二种场景:IT 运维(远程重启)

  • 痛点:机房或弱电间的路由器、服务器死机,需要人工跑一趟去按电源。

  • 解决方案:将网络设备电源插在16A智能插座上,并集成到IT运维平台

    • 逻辑:网络监测到Ping不通 → 运维平台自动调用 {"reset":"10000"} → 插座断电10秒后重开 → 网络设备重启恢复

第三种场景:能耗管理与节能

  • 痛点:下班后饮水机反复加热、下班后工位电源未关。

  • 解决方案:接入企业能耗管理APP

    • 逻辑:系统设定每日20:00 → 轮询所有工位插座 → 读取当前功率数值。

    • 如果功率大于阈值(例如20W) → 判定为设备未关 → 推送消息给对应员工 或 自动执行关闭。

六、 私有化部署与网络策略

对于金融、研发等高安全要求的企业,如果担心数据经过外网,可以利用芯步支持的私有化部署能力

  1. 在企业内部服务器部署芯步的消息接收服务。

  2. 将16A插座配置为指向内网服务器地址。

  3. 内部软件项目完全通过内网API控制插座,实现数据物理隔离,且不依赖外部互联网带宽,响应速度更快。