芯步35A智能电源保护开关通过开放HTTP接口，支持远程状态查询与控制。以下方案涵盖接口协议、签名算法、状态查询实现及私有化部署选项，帮助开发者快速集成。

1. 解决概述

芯步35A智能电源保护开关（以下简称“35A设备”）是一款支持Wi-Fi直连的大功率智能断路器。本方案的目标是指导开发者如何利用芯步提供的标准化HTTP开放接口，将设备快速集成到现有的楼宇自控、能源管理或工业自动化系统中，实现对35A设备的远程状态查询与控制。

通过本方案，开发者无需复杂的嵌入式开发，只需通过简单的HTTP请求即可在Web、APP或PC端软件中实时获取设备的通断状态，从而构建高效的远程运维体系。

2. 核心接口与鉴权机制

芯步的开放接口基于HTTP协议设计，具有语言无关性，支持任何支持HTTP请求的编程环境。所有针对设备状态的查询与控制操作，均需通过签名机制进行身份验证。

2.1 请求基础信息

• 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方式POST

• 数据格式JSON

• 参数说明

  • AppId：应用唯一标识，由芯步平台生成。

  • ts：Unix时间戳（秒），用于防止重放攻击。

  • sign：动态签名，用于验证请求合法性。

2.2 签名算法

为确保接口调用的安全性，需要对请求进行加密签名。具体的签名生成逻辑如下

1. 将芯步平台颁发的 AppSecret 进行MD5加密，得到 secret_md5。

   • 公式：secret_md5 = md5(AppSecret)

2. 将上述得到的 secret_md5 与请求中的时间戳 ts 进行字符串拼接，形成新的字符串 sign_str。

   • 公式：sign_str = secret_md5 + ts

3. 对 sign_str 再次进行MD5加密，得到最终的 sign。

   • 公式：sign = md5(sign_str)

在实际开发中，需确保客户端与服务器时间同步，时间戳误差过大会导致鉴权失败。

3. 实现“远程开关状态查询”

虽然“35A智能电源保护开关”的核心功能与普通的智能通断器（如AC4-10A）控制逻辑类似，但作为保护开关，其状态查询往往依赖于控制命令的响应回执或专门的上行消息机制。

3.1 方案一：被动查询——通过控制命令同步获取状态

根据芯步同类产品的接口定义，通过HTTP指令控制设备时，接口响应通常包含设备动作后的实时状态。这是一种获取当前开关状态的直接方式。

适用场景： 需要同时执行“查询”或“切换”动作时。

代码实现示例（逻辑演示）：

说明：开发者也可以发送保持当前状态的控制指令（如再次设置为当前状态），利用返回包来获取实时状态，但这种方法在物联网实践中会产生一定的网络开销。

3.2 方案二：主动推送——配置消息服务器接收状态变更

对于需要实时监控的应用场景（如异常跳闸监测），仅靠轮询是不够的。芯步支持私有化消息服务器对接，即设备状态发生变化时（例如：由本地手动关闭、或过载保护自动跳闸），平台会主动将状态推送到开发者指定的服务器。

适用场景： 实时监控、能耗分析、报警系统。

实施步骤：

1. 自建服务器：部署一台具有公网IP或与设备在同一局域网内的HTTP/HTTPS服务端。

2. 平台配置：在芯步控制台中，将“消息推送”地址配置为 http://your-server-ip:port/api/receive。

3. 接收数据：当35A设备状态切换（开→关或关→开）或因故障跳闸时，平台会向配置的地址发送POST数据包。

接收数据格式示例：

4. 其他辅助控制功能

除了核心的开关状态查询与控制，35A设备通常支持基于HTTP接口的更多精细化配置

• 功率/电压阈值设置：通过指令设定过载保护阈值，当实时功率超过设定值时，设备自动跳闸并上报状态。

• 定时与循环任务：通过HTTP接口设定设备的定时开关策略（例如：每日9点开启，18点关闭）。

• 状态锁定：设置“状态保持”模式，例如，强制设备保持开启状态，本地按键暂时失效，防止误触。

5. 网络架构与部署模式

35A设备直接通过Wi-Fi 2.4G接入网络，无需额外的网关硬件。在集成时，可根据项目需求选择以下两种网络模式

• 公有云模式（公网）：设备连接互联网，开发者通过调用芯步云API进行状态查询。此种方式适用于分布式的、跨地域的连锁或分布式能源管理项目。

• 私有化模式（局域网）：芯步开放接口支持纯局域网环境运行。如果35A设备与业务服务器处于同一局域网段（或同一VPN下），HTTP请求可直接通过设备IP或本地API路由完成，无需经过外网，具有低延迟、高安全的特点。

6. 总结

通过对接芯步35A智能电源保护开关的HTTP开放接口，开发者可以在1-2天内快速打通从“软件层”到“硬件执行层”的数据链路。无论是通过主动轮询查询状态，还是利用消息服务器接收跳闸报警，该方案均能实现毫秒级的响应速度，为企业提供可靠的用电安全远程监控解决方案。