芯步智能通断器AC3基于开放HTTP接口，具备开关控制、电量计量、功率保护三大核心能力。以下是完整的接入方案，涵盖硬件准备、接口对接、能耗统计逻辑和典型应用场景。
1. 背景与需求
在物联网应用场景中，远程控制设备通断并实时监测能耗数据，是智能楼宇、自动化农业、共享设备、智慧机房等领域的常见需求。传统的断路器或插座无法提供用电数据反馈，导致能耗管理粗放，无法实现精细化控制和告警。
芯步智能通断器AC3 是一款支持WiFi直连、无需网关、开放完整HTTP API的智能控制设备。它不仅能远程控制电路通断，还支持电量计量功能（计量版），可实时采集电压、电流、功率、累计用电量等数据，开发者可通过标准HTTP接口快速接入第三方系统，实现能耗统计与智能控制的一体化解决方案。
本方案将详细介绍如何通过芯步开放接口，完成智能通断器AC3的接入、控制、能耗数据采集及统计应用的完整开发流程。
2. 产品核心能力与选型
2.1 产品规格说明
| 参数项 | 规格说明 |
|---|---|
| 产品型号 | UNI-TDQ-AC3-10A（普通版 / 计量版）/ 16A |
| 工作电压 | AC 85-265V（宽压，适用全球市电） |
| 额定电流 | 10A / 16A 可选 |
| 最大负载 | 10A：阻性负载2200W，感性负载约700W16A：阻性负载3500W |
| 无线协议 | WiFi 2.4GHz（支持5组网络热备） |
| 控制接口 | HTTP API（JSON over POST） |
| 特色功能 | 远程通断控制、电量计量（计量版）、功率保护、定时任务、先通后断/先断后通时序控制 |
| 体积 | 37×74.3×23.5mm（10A版），可嵌入设备内部 |
2.2 选型
仅需远程开关：选择AC3普通版（10A/16A），成本更低
需要统计电量、功率监测：必须选择 AC3计量版（型号后缀
-P），该版本提供实时电压、电流、功率、累计用电量等数据负载功率参考：常规家电、照明、水泵选10A计量版；空调、大功率电机选16A版
3. 整体架构
整个解决方案由四层构成：
设备层：智能通断器AC3计量版，连接被控电器（空调、水泵、充电桩、照明等）
网络层：AC3通过2.4G WiFi连接互联网，无需网关，降低部署成本
平台层：芯步云平台，提供HTTP API接口、设备管理、消息推送能力
应用层：开发者自建的业务系统（能耗看板、告警服务、自动化策略、小程序等）
数据流向
下行控制：业务系统 → 芯步云API → AC3设备 → 执行开/关/时序动作
上行数据：AC3采集电量 → 芯步云 → 业务系统（通过主动查询或消息订阅）
4. 快速接入准备
4.1 平台侧配置
注册并登录芯步控制台（）
获取开发者凭证：在“开发设置”中记录 AppID 和 AppSecret（开发者密码）
获取设备ID：给AC3通电并完成配网后，在控制台“设备列表”中查看 Device ID（如
1878）选配功能：如需快速测试接口，可开启“调试模式”（此时不校验签名和IP白名单）；生产环境请关闭调试模式
4.2 设备上电配网
AC3支持WiFi直连，通过官方小程序或App为其配置WiFi（SSID + 密码）。设备支持预设5组WiFi热备，自动选择信号最强网络连接，提高稳定性。
5. 接口对接详解
芯步的开放接口采用HTTP格式，鉴权方式为动态签名。任何支持HTTP请求的编程语言（Python、Java、Go、PHP、JS、Shell等）均可快速接入。
5.1 签名算法（生产环境必需）
接口请求中需要携带 sign 和 ts（时间戳，秒），签名生成规则如下：
关键点
ts为当前Unix时间戳（秒），服务器会校验与服务器时间差（通常允许5分钟内偏差）每次请求都应重新计算签名，不可使用固定值
Python示例
5.2 核心API：设备控制
请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
Method：POST
Content-Typeapplication/json
请求体
常用命令（order字段）
| 功能 | order JSON | 说明 |
|---|---|---|
| 开启线路 | {"power":"1"} | 接通继电器，设备供电 |
| 关闭线路 | {"power":"0"} | 断开继电器 |
| 开启计量 | {"metering":"1"} | 计量版专用，启用实时数据采集 |
| 关闭计量 | {"metering":"0"} | 停止采集 |
| 先通后断 | {"point":"3000"} | 先接通，延迟3000毫秒后断开（脉冲控制） |
| 先断后通 | {"reset":"3000"} | 先断开，延迟3000毫秒后接通（断电重启） |
返回值：标准HTTP状态码 + JSON响应体（包含执行结果、错误码等）。
cURL示例
5.3 能耗数据获取方式
AC3计量版支持实时上报或主动查询能耗数据。查询命令如下：
获取实时功率/电压/电流：通过
order中的特定查询指令（具体请查阅芯步产品手册详情页，一般通过设备属性读取接口或消息推送）获取累计用电量（kWh）：同样通过查询接口，返回从清零开始的累计电量
典型数据结构（示例）：
重要提示：能耗数据需在设备上电后执行一次 {"metering":"1"} 命令，设备才会开启计量并上报数据。另外，设备常规状态是周期性上报数据到云端，业务系统可以通过芯步提供的数据订阅接口（如消息队列、Webhook等）接收实时推送，或采用定时轮询设备详情感知最新值。
6. 能耗统计与控制业务流程实现
基于上述接口，可构建完整的能耗管理闭环。
6.1 轮询采集 + 数据库存储
实现一个定时任务（如每5分钟或15分钟执行），调用AC3的查询接口获取当前功率和累计电量，写入时序数据库（如InfluxDB、TimescaleDB）或MySQL。
核心逻辑
6.2 异常用电告警（过载/超功率）
AC3计量版支持在云端设置功率上限。当实时功率超过设定阈值时，平台可自动执行：
触发HTTP回调（Webhook）通知业务系统
或直接下发
{"power":"0"}命令切断电路，保护线路安全
业务系统处理
接收告警后，通过钉钉、微信、短信通知运维人员
记录告警事件到日志表，便于事后分析
6.3 精细化控制策略（时序控制）
AC3支持 point 和 reset 命令，实现“点动”或“重启”场景：
场景1：自动门禁或道闸：发送
{"point":"5000"}，接通5秒后自动断开，避免长时间通电场景2：远程重启路由器/摄像头：发送
{"reset":"10000"}，先断开10秒，再自动接通，实现设备硬重启
6.4 数据可视化与统计报表
在业务系统前端（如Vue/React）调用后端API，生成：
实时看板：当前功率、今日用电量、设备在线状态
历史曲线：近24小时功率变化趋势，识别高能耗时段
用电报表：按日/周/月统计累计用电量（kWh），支持导出
成本核算：结合电价（如0.6元/度），自动计算电费
7. 应用场景举例
7.1 智慧充电桩（扫码供电）
用户扫码支付后，业务系统调用 {"power":"1"} 接通充电插座，同时开启 metering；充电结束或费用耗尽时发送 {"power":"0"} 断电，并从设备读取累计用电量用于计费。
7.2 机房动环监控
部署AC3计量版在机柜PDU前端，实时监测机柜功率，当功率超过机柜设计容量（如3kW）时自动切断新增负载，或推送告警。同时采集各机柜PUE相关数据。
7.3 农业大棚/养殖场
定时控制风机、水泵、照明；结合温湿度传感器逻辑，当温度过高时自动接通排风扇 {"power":"1"}。计量功能可监测设备是否正常运行（如功率为0表示设备故障）。
7.4 共享设备/租赁管理
在洗衣机、烘干机、售卖机内嵌AC3，用户通过小程序预约并支付后远程通电，归还或结束使用后断电，并记录用电量作为成本分摊依据。
8. 注意事项与最佳实践
签名有效期
ts采用服务器当前时间戳，并与业务服务器时间同步（NTP），避免因时间偏差导致签名验证失败设备ID格式：设备ID为纯数字字符串，支持批量控制多个设备：
device="1878,1879,1880"，但需注意接口单次批量上限计量版初始化：新设备首次使用或断电重启后，需主动下发
metering命令开启采集，否则无法获取电能数据网络稳定性：虽然AC3支持5组WiFi热备，仍部署在WiFi信号良好的区域。高可靠性场景可考虑定时发送心跳确保在线
开放接口扩展：除设备控制外，芯步还提供设备分组、定时任务、场景联动等API，可实现更复杂的自动化规则
私有化部署选项：对于数据安全要求高的企业，AC3支持私有化部署，所有数据可运行在局域网内，不上传公网
9. 结语
通过芯步智能通断器AC3与标准HTTP API的结合，开发者可在无需硬件底层知识的情况下，快速构建具备远程控制、电量计量、功率保护、自动化策略的物联网能耗管理系统。无论是公网SaaS模式还是私有化部署，AC3的开放能力都能满足从简单开关到复杂能耗分析的多层次需求。
下一步，您可以直接登录芯步控制台获取AppID和演示设备，按照本方案中提供的代码示例进行接口调试，10分钟内即可完成首次控制。