60A导轨式智能断路器属于工业级强电设备，接入时核心关注两点：一是签名鉴权机制（MD5嵌套+时间戳防重放），二是状态查询的两种模式——主动查询用device/status接口，被动接收需配置消息服务器。以下方案按“环境准备→接口调试→系统集成”顺序展开。

解决方案：基于芯步开放接口接入60A导轨式智能断路器

1. 产品概述与准备工作

1.1 产品概述芯步60A导轨式智能断路器（型号：UNI-DLQ-M-60A）是一款支持远程控制的工业级强电管理设备。它具有以下特点：

• 大功率承载：额定电流60A，适用于楼层总闸、充电桩、大型设备等场景。

• 直连网络：内置WiFi模块（支持2.4G频段），无需额外网关，可直连路由器。

• 接口开放：提供全量HTTP API接口，支持任意后端语言调用，响应速度约80-120ms。

1.2 准备工作在开发前，请确认以下信息已就位：

1. 硬件就绪：设备已按照说明书接线并通电，指示灯状态正常。

2. 网络配置：已通过“芯步”小程序或控制台将设备配网至目标2.4G WiFi。

3. 凭证获取

   • AppID：应用唯一标识。

   • AppSecret：开发者密钥（用于签名计算）。

   • Device ID：设备的唯一ID（在控制台设备列表查看）。

4. 接口地址http(s)://api.thingboot.com/{AppId}/device/control/。

2. 核心技术原理：接口鉴权与签名机制

芯步的接口采用动态签名验证，所有API调用必须在URL参数中携带 sign 和 ts。签名算法如下：

签名生成步骤：

1. 第一次MD5加密：encSecret = md5(AppSecret)

2. 拼接时间戳：signStr = encSecret + ts （ts为Unix时间戳，单位秒）

3. 第二次MD5加密：sign = md5(signStr)

伪代码示例：

3. 核心功能实现：远程开关与状态查询

针对“开关状态查询”的需求，主要通过两种方式实现：主动查询（下行） 和 被动接收（上行）。

3.1 主动查询：获取断路器实时状态

芯步的设备状态通常作为属性存在于设备中。虽然控制命令通常下发order，但查询状态一般通过设备信息接口或读取设备上报的最新数值。

实际操作方法：要获取当前状态，通常需要调用“获取设备信息”或“查询设备状态”的API（具体路径可查阅官方设备手册）。在通用逻辑中，查询状态一般通过以下方式：

1. 调用 device/info 类接口。

2. 或者，发送一条空指令或状态读取指令。

但更为推荐的方案是： 当您下发 {"status":"?"} 或直接利用下文提到的“被动接收”机制，因为断路器状态可能在本地物理按键按下时改变，主动查询无法实时获知物理操作。

3.2 被动接收：通过消息服务器接收实时状态

这是实现“状态查询”最稳妥的方案。设备状态发生变化时（如：本地按钮被按下、过载跳闸、远程遥控成功），设备会主动上报状态。

配置步骤：

1. 在芯步控制台中，配置“第三方推送”或“API转发”。

2. 填写您的服务器接收URL（Endpoint）。

3. 当断路器状态改变时，平台会向该URL推送JSON数据包。

接收到的状态示例：

3.3 执行远程开关控制

若需要远程执行分合闸，通过HTTP POST请求发送控制命令。

请求示例：

• URL: https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• Method: POST

• Header: Content-Type: application/json

• Body:

注：根据搜索结果显示，具体的order指令需参考UNI-DLQ-M-60A的产品手册，部分设备可能支持多路控制，指令可能为power1、power2等。

4. 系统集成步骤（以Java/Python/Nodejs为例）

无论您的系统是Web SaaS、APP还是微信小程序，集成逻辑均如下

步骤1：封装签名工具编写一个函数，输入AppSecret和ts，输出sign。确保时间戳与签名的实时性。

步骤2：编写控制服务创建一个异步任务，接收前端指令，拼接参数请求芯步API。

示例代码片段（基于Python Flask）：

步骤3：处理回调（Webhook）搭建一个公网可访问的Endpoint（如 https://yourdomain.com/iot/callback），接收设备的状态推送，并更新到您的业务数据库。

5. 常见问题与排障指南

1. 签名错误（501/403）

   • 原因：绝大多数是时间戳相差超过阈值（通常为5分钟）或MD5计算顺序错误。

   • 解决：确保服务器时间是标准北京时间，检查拼接字符串顺序是否为 md5(secret) + ts。

2. 设备离线

   • 原因：现场WiFi信号弱或断电。

   • 解决：当前设备支持5组WiFi备选，可配置多个热点；检查2.4G频段是否开启（不支持5G WiFi）。

3. 状态同步不及时

   • 解决：不要仅依赖控制接口返回的success作为状态，必须实现消息接收服务器来同步物理按键操作或异常跳闸状态。

4. 局域网控制

   • 若需内网使用且断外网，可参考芯步的私有化部署方案，API地址切换至内网服务器IP即可。

总结

通过芯步的开放接口接入60A导轨式智能断路器，开发者仅需关注签名鉴权和HTTP请求解析两个环节。系统架构上，采用“下发控制命令”+“接收消息推送”的双通道模式，确保对工业设备状态的实时、准确掌控。