芯步的25A智能空开采用HTTP接口开放策略，签名机制统一、命令格式规范，接入成本可控。以下方案从设计、接口调用、设备配网到工程落地逐层展开。

解决方案：基于芯步25A联动控制智能空开的项目集成方案

1. 概述与适用场景

本方案的目标是指导开发者如何利用芯步开放的HTTP接口，将 UNI-DLQ-25A 智能断路器（25A联动控制智能空开）快速集成到现有的门店管理、能源管理或智能办公系统中。

该设备适用于 总功率5000W以内 的阻性负载（如照明、空调、普通插座回路），若用于电机或LED灯带，负载控制在800W以内以确保稳定。典型的应用场景包括：便利店收银系统联动切电、无人店远程复位、办公区定时断电等。

2. 整体设计

我们将采用 云云对接 的架构模式，不依赖特定的硬件网关，通过公网API直接控制设备。

• 控制链路：你的业务后端 <-- HTTPS --> 芯步开放平台 API <-- MQTT/WiFi --> 25A智能空开

• 数据流向：业务逻辑触发 -> 生成签名 -> 发送指令 -> 平台推送给设备 -> 设备执行 -> 返回状态。

• 优势：只要门店路由器联网，即可实现远程控制；你的项目只需具备发送HTTP请求的能力（任何后端语言、小程序云函数、甚至可视化低代码平台均可）。

3. 集成前的准备与设备配网

在编写代码前，需要完成账号与设备的初始化工作：

1. 注册与创建：注册芯步开发者账号，创建一个“工作台”（对应你的项目空间）。

2. 获取密钥：在“物联网控制台” -> “开发设置”中，获取核心凭证：

   • AppID：用于标识你的应用。

   • AppSecret：用于生成签名（请保管好，切勿放在前端）。

3. 设备配网

   • 给25A空开接通市电（AC 85-265V），并通过导轨安装固定。

   • 进入“芯步小程序”或控制台“网络配置”页，输入门店的 2.4G WiFi 密码（不支持5G频段）。

   • 通过“热点配网”模式（手机开启热点设为特定名称）让设备快速连上云端。配网成功后，在控制台的设备列表中会看到该设备生成的唯一 Device ID。

4. 核心对接开发：API调用实战

芯步的接口设计统一，难点主要集中在 动态签名的生成 上。所有API请求均需携带 sign 和 ts（时间戳）进行防篡改验证。

4.1 签名生成规则不仅是空开，所有芯步设备共用此规则：

1. 先计算 AppSecret 的 MD5: str1 = md5(AppSecret)
2. 拼接时间戳: str2 = str1 + ts (当前秒级时间戳)
3. 最终签名: sign = md5(str2)

注：如果开发测试期间想绕过签名校验，可在“开发设置”中开启“调试模式”，但生产环境请一定要关闭。

4.2 控制单台设备通断针对25A空开，最核心的命令是控制其主回路通断。

• 请求地址https://api.thingboot.com/[Your_AppID]/device/control/?sign=[Your_Sign]&ts=[Timestamp]

• Method：POST

• HeaderContent-Type: application/json

• Body 示例

4.3 进阶控制策略除了简单的通断，该空开通过不同的 order 参数支持更复杂的业务逻辑

• 批量控制（多台空开）：如果你的项目中有多个配电回路，用逗号分隔 Device ID，实现统一拉闸。

  "device": "110523,110524"

• 定时/延迟动作

  • 先通后断：适用于复位网络设备（如路由器重启）。命令：{"point":"2000"} （即瞬间闭合，持续2秒后自动断开）

  • 先断后通：适用于能耗清零或设备冷重启。命令：{"reset":"3000"} （断开后，等待3秒自动闭合）

• 状态锁定：通过 {"keep":"1"} 等参数，可以屏蔽设备上的实体按钮，防止店内工作人员误触，远程优先。

5. 数据安全与防误触机制

在门店电路控制中，安全性是第一位的。在项目中实现以下机制：

1. 权限分级：你的业务系统应做角色控制。普通店员仅能查询状态，店长/经理才能执行“断电”操作。

2. 操作确认：对于“断电”这类破坏性操作，前端应设置二次确认弹窗，后端可增加“操作时间窗口”校验（例如非营业时间禁止断电）。

3. HTTPS 强制：接口调用必须使用 HTTPS 协议，防止在内网被抓包篡改指令。

6. 落地步骤总结

通过以上方案，你可以利用芯步标准化的开放能力，将复杂的强电控制简化为几行HTTP代码，快速落地门店的电气智能化管理。