60A计量版空开支持通过HTTP接口直接进行远程通断控制，核心是调用控制接口并携带正确的签名认证和设备命令。以下是完整的对接方案。
一、 产品核心特性与接口优势
芯步的智能大功率断路器[计量版]（型号：UNI-DLQ-M-60A-P）专为工业及大功率商业场景设计。其核心开放能力如下：
直连架构：设备内置WiFi模块（仅支持2.4G频段），无需额外购买网关，上电即可直连路由器。
接口通用性：开放标准HTTP接口，无论您的后端服务是Java、Python、PHP还是运行在微信小程序、原生APP，均可通过发送HTTP请求完成控制。
部署灵活性：支持公网SaaS模式和私有化部署。即便在纯局域网环境下，也可搭建本地服务器进行内网控制，保障数据安全。
二、 API接口请求详解
要实现对60A空开的远程通断，核心在于调用设备控制接口。接口采用签名机制保障安全性。
1. 请求地址与鉴权
请求URL：
http(s)://api.thingboot.com/{AppId}/device/control/请求方法：
POST鉴权参数（URL参数）：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
sign | String | 是 | 动态签名，用于身份验证 |
ts | String | 是 | UNIX时间戳（秒），需与签名计算时一致 |
Header
Content-Type: application/json
2. 签名计算规则
为了防止接口被恶意篡改，需要对请求进行签名。签名算法为：sign = md5( md5(AppSecret) + ts )
AppSecret： 开发者密码（在芯步控制台获取）。ts： 请求发起时的Unix时间戳。+： 字符串拼接。
签名逻辑示例（伪代码）
secret_md5 = md5(AppSecret) // 第一步:将AppSecret取MD5 raw_string = secret_md5 + ts // 第二步:拼接时间戳字符串 sign = md5(raw_string) // 第三步:整体取MD5
3. 请求体构建
请求Body为JSON格式，包含两个关键字段：device 和 order。
单路控制（标准60A空开）该设备默认控制单路大功率线路。
开启：
{"power": 1}关闭：
{"power": 0}
多路控制（如果是多路版本或PDU设备）若您使用的是类似智能PDU或多路开关，需使用带编号的命令。
开启第1路：
{"power1": 1}关闭第4路：
{"power4": 0}
完整请求示例
POST /your_app_id/device/control/?sign=xxxxxx&ts=1704067200 HTTP/1.1
Host: api.thingboot.com
Content-Type: application/json
{
"device": "123456789",
"order": {"power": 1}
}三、 代码对接实战
以下提供几种常见开发语言的集成示例，核心逻辑均为构造签名与发送POST请求。
Python 示例
Java 示例
利用 Unirest 或 OkHttp 库，关键点在于使用 DigestUtils 处理MD5。
Shell 脚本示例
适用于运维脚本或边缘网关快速测试。
四、 数据上报与联动场景
除了下发“通断”命令，该计量版空开的核心价值在于计量数据的实时上报。
数据流向设备会定时或在状态变化时，主动向服务器上报电压、电流、功率、今日用电量（度）等数据。
对接
如果使用公有云：您需要在芯步控制台设置“消息推送URL”，平台会将设备上报的JSON数据实时转发至您的业务系统。
如果私有化部署：设备直接连接您的本地MQTT Broker或HTTP Server，您可以完全掌控数据流向。
高级联动逻辑利用上报的数据，您可以实现复杂的业务逻辑：
超限关断：实时监测功率数据，若某设备功率超过阈值（如60A满载），业务系统自动下发
{"power": 0}指令进行过载保护。定时任务：通过HTTP接口配合定时任务（如Linux Crontab或Jenkins），实现排风扇、照明的定时开关。
五、 网络配置与设备激活
在进行接口对接前，需要确保设备联网成功。该设备采用WiFi快速配网机制
准备工作：手机连接2.4G WiFi频段（不支持5G）。
操作步骤
关注“芯步”微信小程序或登录PC控制台。
输入当前的WiFi密码，生成包含密码的二维码/热点。
空开设备上电后处于待配网状态（指示灯闪烁），通过特定操作（如长按复位键）让设备捕获配置信息。
设备自动连接指定路由器，指示灯常亮即表示在线成功。
获取设备ID：配网成功后，控制台或小程序中会显示唯一的
device_id，该ID即为后续接口操作的目标。
六、 常见问题与排障
签名错误（401/403）
检查时间戳
ts单位是否为秒（10位数字），而非毫秒。严格按照
md5(md5(AppSecret) + ts)顺序，注意拼接的是md5值与时间戳字符串，而不是原始AppSecret。
设备离线
确认设备端指示灯状态。若不亮，检查空开进线端是否有电。
确认现场WiFi信号强度，该设备虽然支持5组WiFi备用，但仍需保证信号覆盖。
如果是企业网络，请检查防火墙是否屏蔽了
api.thingboot.com的443端口。
获取计量数据
命令接口
control仅用于控制。要获取实时电流电压，需订阅设备上报的消息。私有化部署用户搭建HTTP服务端接收设备POST来的数据包。
通过以上方案，开发者可以快速将芯步的60A计量空开集成到任何现有软件系统中，实现远程合闸、分闸及电力监控。