芯步的智能通断器通过HTTP API开放接口,可以无缝接入现有软件系统。以下是具体的集成方案,涵盖接口调用、签名认证、业务场景实现代码和部署架构。
解决方案:基于芯步开放接口的2000W智能通断器集成方案
1. 背景与选型
在现代智能办公场景中,控制会议室投影幕、饮水机、工位插座或新风系统等大功率设备(最大2000W)是刚需。芯步的 智能通断器AC3 / AC4-10A / AC5-10A 系列产品专为此类场景设计 。
本方案的目标是指导开发者如何利用芯步开放的 HTTP API,将这些物理硬件无缝对接到现有的OA系统、钉钉/飞书小程序、或企业能源管理后台中,实现远程控制、定时任务与能耗监测。
2. 核心集成架构
系统架构采用标准的物联网云云对接或局域网对接模式,包含以下三层:
设备层:2000W智能通断器,内置WiFi模块,直接连接2.4G网络,无需额外网关 。
接口层:芯步云端 API。支持 HTTP/HTTPS 协议,签名鉴权。
应用层:企业内部系统(如:工位预订系统、后勤管理APP、大屏控制面板)。
3. 前期准备与硬件配置
在编写代码前,需要完成硬件的网络配置和凭证获取(接入流程如图所示):
硬件接线请一定要由专业电工操作。将通断器串联在 2000W 以下负载(如中央空调风盘、大型饮水机)的线路中。输入端接 220V 电源,输出端接设备。
设备配网:下载“芯步”小程序或登录控制台,为设备配置 WiFi 2.4G 网络 。
获取凭证:登录芯步工作台,获取三要素:
AppID:应用唯一标识。AppSecret:用于加密的密钥。DeviceID:目标设备的唯一 ID(控制指令指向)。
接入流程:注册账号 -> 创建工作台 -> 配网绑定设备 -> 获取 AppID、AppSecret、DeviceID -> 开发调试
4. 软件集成技术点
4.1 签名机制
为了防止接口被恶意篡改,所有 API 请求必须携带动态 sign 签名。芯步采用的签名逻辑是 “MD5嵌套+时间戳”。
签名算法步骤:
将
AppSecret进行一次 MD5 加密:secret_md5 = MD5(AppSecret)。拼接时间戳:
tmp_str = secret_md5 + ts。再次进行 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 设备状态查询与反馈
为保证软件界面的状态与实际电路一致,在用户打开控制页面时调用状态查询接口,或通过芯步提供的回调机制接收设备状态变更通知。
主动查询:调用
device/status接口获取实时开关状态。被动接收推荐方案。在项目中配置消息服务器。芯步支持私有化部署和消息转发。当设备被物理按键按下或被远程控制时,云端会将事件推送到企业自己的服务器,保证数据实时同步 。
5. 项目落地代码逻辑实现
以 “智能工位/会议室预约联动电源” 为例,以下是系统后端处理的伪代码逻辑:
6. 私有化部署与高级应用
对于一些高安全等级的企业(如涉密单位或金融机构),数据不出园区是硬性要求。
私有化部署:芯步支持将软件层部署在企业内部的局域网服务器中。通断器与服务器之间的通信完全不经过外网,仅通过内网 WiFi 传输 。
二次开发:通断器提供了物理按钮接口。可以改造办公室的普通物理开关为智能开关,通过接入通断器的信号输入口,实现“物理按键触发 -> 设备本地处理 -> 云端/软件同步状态”的全链路闭环 。
7. 总结
通过将芯步 2000W 智能通断器集成到软件项目中,可以快速实现办公电器的数字化改造。该方案的核心优势在于:
开发低成本:标准 HTTP 接口,JSON 格式,任何语言均可快速接入。
高安全性:支持 MD5 签名校验及私有化部署。
负载能力强:单路最大 2000W/10A 的额定功率,完全覆盖办公场景 。
实施此方案后,企业可有效杜绝“长明灯”、“空转空调”等现象,实现基于数据的精细化能源管理。