芯步的40A导轨式数显断路器支持HTTP接口对接，可通过签名认证调用API实现电压、电流、功率等电能参数的实时读取与通断控制。以下方案涵盖接口调用流程、命令示例及数据回调配置。
1. 产品概述与接口能力
芯步的智能大功率断路器[计量数显版]（40A）是一款支持标准DIN导轨安装的物联网智能硬件。不仅支持远程控制通断，还内置了电量计量模块，能够实时监测电压、电流、功率等关键电力参数。
该产品的核心优势在于其全面开放的HTTP API接口。开发者无论使用何种编程语言（如Java、Python、PHP、Go），或开发何种平台（Web、App、小程序、SaaS），仅需通过标准的HTTP POST请求即可完成对接，无需复杂的MQTT协议配置，学习成本低、开发效率高。
为了实现“电流电压监测”的目标，本方案将重点解决两个核心问题：
主动查询：如何通过接口主动获取设备的实时电流电压数据。
被动接收：如何配置平台，让设备在上报数据时，将电流电压数据自动推送到客户的私有服务器（Webhook）。
2. 对接准备与鉴权机制
在开始编码前，需要在芯步云平台获取开发者凭证。
2.1 获取凭证
AppID：应用的唯一标识（在控制台的“开发设置”中获取）。
AppSecret：开发者密码，用于生成签名，保障接口安全。
Device ID：设备的唯一ID（可在控制台查看或通过接口拉取）。
2.2 签名算法
芯步的接口采用双重MD5加密方式进行鉴权，这是调用所有接口的前提。
参数
ts：当前Unix时间戳（秒）。sign：计算后的签名。
计算公式
sign = md5( md5(AppSecret) + ts )
示例：假设
AppSecret为abc123，ts为1700000000。
计算
md5(abc123)得到e99a18c428cb38d5f260853678922e03。拼接字符串得到
e99a18c428cb38d5f260853678922e031700000000。再次进行MD5得到最终的
sign。
3. 实现方案一：主动查询电流电压数据
如果你需要在用户点击按钮或定时任务中主动获取最新的电流电压数据，由于40A断路器本身会上报数据，你可以利用平台提供的“设备状态查询”接口或直接从平台回调中获取最新值。但根据通用HTTP控制逻辑，通常下发命令和读取状态是分离的。
操作流程：通过HTTP接口下发读取指令 -> 设备响应 -> 平台返回包含计量信息的JSON数据。
3.1 请求地址与Header
3.2 请求体（Body）
为了获取计量数据，通常不需要特殊的“读取”命令，因为设备会定时或在状态变化时主动上报。但如果必须查询，你需要指定device的ID，并通过order字段（通常为空或特定查询指令）。根据官方文档，该系列设备支持功率计量版实时上报计量数据，因此对接的关键在于配置“接收”而不是“轮询”。
3.3 各语言场景调用示例
虽然设备是40A断路器，但芯步同一品类的接口命令高度一致。以下是一个通用的控制调用示例（例如控制通断），查询逻辑类似，通过配置消息推送来获取计量数据。
PHP 示例：
注：此代码段演示了HTTP接口的调用结构，具体读取电压电流请结合下文的消息推送。
4. 实现方案二：被动接收电流电压数据（推荐）
对于“电流电压监测”类场景，被动接收是最优雅高效的方案。芯步支持服务端消息推送功能，当断路器检测到电力参数变化或按固定频率上报时，会主动将数据POST到开发者指定的公网URL（Webhook）。
4.1 配置回调URL
在芯步工作台的“物联网控制台”中，需要设置“消息推送”或“服务端API”地址。填入你的服务器公网地址，例如：https://yourdomain.com/api/yoyo/callback。
4.2 接收数据的结构体解析
当40A断路器上报数据时，你的服务器（以Python Flask为例）会接收到一个包含详细计量信息的JSON包。根据设备能力，推测数据结构中会包含以下关键字段：
4.3 实现数据可视化与告警
一旦服务器能稳定接收到电流电压数据，开发者可以实现以下高阶功能：
实时监测看板：利用WebSocket将收到的消息推送到前端，实时绘制电压电流曲线图。
电费统计：累加
energy（电量）字段，计算每个回路（如空调、照明）的日/月耗电量。异常预警：设定电压上限（如250V）或下限（如190V），当数据触发阈值时，系统自动调用
/device/control/接口，发送{"power1":0}命令切断电路，实现“监测-控制”闭环。
5. 总结和需要注意的点
通过芯步的开放接口对接40A导轨式数显断路器，开发者无需关心底层硬件通信协议，只需专注于HTTP接口交互和数据业务处理。
关键步骤回顾：
鉴权：记住双重MD5的签名生成规则。
控制：使用HTTP POST控制通断（
{"power1":1}）。监测：配置“服务端消息推送”接口，被动接收电压电流数据，这种方式实时性最高且最节省服务器资源。
注意事项：
网络环境：设备通常只支持2.4G WiFi，确保现场网络环境符合要求。
数据频率：计量数据的上报频率可以在设备配置中进行设置，需平衡实时性与设备功耗/服务器压力。
兼容性：本文所述方法适用于芯步全系列通断器及计量产品，接口逻辑统一。