CATALOG

芯步的智能通断器通过HTTP API开放接口,可以无缝接入现有软件系统。以下是具体的集成方案,涵盖接口调用、签名认证、业务场景实现代码和部署架构。

解决方案:基于芯步开放接口的2000W智能通断器集成方案

1. 背景与选型

在现代智能办公场景中,控制会议室投影幕、饮水机、工位插座或新风系统等大功率设备(最大2000W)是刚需。芯步的 智能通断器AC3 / AC4-10A / AC5-10A 系列产品专为此类场景设计

本方案的目标是指导开发者如何利用芯步开放的 HTTP API,将这些物理硬件无缝对接到现有的OA系统、钉钉/飞书小程序、或企业能源管理后台中,实现远程控制、定时任务与能耗监测。

2. 核心集成架构

系统架构采用标准的物联网云云对接或局域网对接模式,包含以下三层:

  • 设备层:2000W智能通断器,内置WiFi模块,直接连接2.4G网络,无需额外网关

  • 接口层:芯步云端 API。支持 HTTP/HTTPS 协议,签名鉴权。

  • 应用层:企业内部系统(如:工位预订系统、后勤管理APP、大屏控制面板)。

3. 前期准备与硬件配置

在编写代码前,需要完成硬件的网络配置和凭证获取(接入流程如图所示):

  1. 硬件接线请一定要由专业电工操作。将通断器串联在 2000W 以下负载(如中央空调风盘、大型饮水机)的线路中。输入端接 220V 电源,输出端接设备。

  2. 设备配网:下载“芯步”小程序或登录控制台,为设备配置 WiFi 2.4G 网络

  3. 获取凭证:登录芯步工作台,获取三要素:

    • AppID:应用唯一标识。

    • AppSecret:用于加密的密钥。

    • DeviceID:目标设备的唯一 ID(控制指令指向)

接入流程:注册账号 -> 创建工作台 -> 配网绑定设备 -> 获取 AppID、AppSecret、DeviceID -> 开发调试

4. 软件集成技术点

4.1 签名机制

为了防止接口被恶意篡改,所有 API 请求必须携带动态 sign 签名。芯步采用的签名逻辑是 “MD5嵌套+时间戳”

签名算法步骤:

  1. AppSecret 进行一次 MD5 加密: secret_md5 = MD5(AppSecret)

  2. 拼接时间戳: tmp_str = secret_md5 + ts

  3. 再次进行 MD5 加密: sign = MD5(tmp_str)

代码示例(Python 版签名生成):

4.2 向设备下发指令

这是集成的核心 API。通过此接口,软件可以直接控制物理电路的通断。

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

  • 参数device (设备ID) 和 order (JSON 命令)。

典型业务逻辑实现:

  • 场景 A:管理员远程关闭“忘记关的会议室空调”

  • 场景 B:一键开启“演示模式”控制投影幕布下降(假设幕布电机接在通断器上),开启后可设置延时,防止电机堵转。

  • 场景 C:多路批量控制如果一个办公室内有多个会议室的设备需要统一管理,可以批量发送指令

4.3 设备状态查询与反馈

为保证软件界面的状态与实际电路一致,在用户打开控制页面时调用状态查询接口,或通过芯步提供的回调机制接收设备状态变更通知。

  1. 主动查询:调用 device/status 接口获取实时开关状态。

  2. 被动接收推荐方案。在项目中配置消息服务器。芯步支持私有化部署和消息转发。当设备被物理按键按下或被远程控制时,云端会将事件推送到企业自己的服务器,保证数据实时同步

5. 项目落地代码逻辑实现

“智能工位/会议室预约联动电源” 为例,以下是系统后端处理的伪代码逻辑:

6. 私有化部署与高级应用

对于一些高安全等级的企业(如涉密单位或金融机构),数据不出园区是硬性要求。

  • 私有化部署:芯步支持将软件层部署在企业内部的局域网服务器中。通断器与服务器之间的通信完全不经过外网,仅通过内网 WiFi 传输

  • 二次开发:通断器提供了物理按钮接口。可以改造办公室的普通物理开关为智能开关,通过接入通断器的信号输入口,实现“物理按键触发 -> 设备本地处理 -> 云端/软件同步状态”的全链路闭环

7. 总结

通过将芯步 2000W 智能通断器集成到软件项目中,可以快速实现办公电器的数字化改造。该方案的核心优势在于:

  1. 开发低成本:标准 HTTP 接口,JSON 格式,任何语言均可快速接入。

  2. 高安全性:支持 MD5 签名校验及私有化部署。

  3. 负载能力强:单路最大 2000W/10A 的额定功率,完全覆盖办公场景

实施此方案后,企业可有效杜绝“长明灯”、“空转空调”等现象,实现基于数据的精细化能源管理。