芯步的智能通断器AC3-10A计量版通过HTTP接口对外开放控制能力，使得将其接入共享场馆系统变得直接——无需网关、无需私有协议适配，用标准的HTTP请求即可完成开关控制与电量采集。以下方案从接口对接、数据消费到业务场景，给出完整的技术路径。
一、 解决概述
本方案的目标是利用芯步智能通断器 AC3-10A 计量版 的开放 HTTP 接口，将其无缝集成到共享场馆（如共享会议室、健身房、自习室、球场包间）的软件管理后台（SaaS）或小程序中。
核心目标：
远程控制： 用户下单后自动通电，使用结束后自动断电。
计量计费： 实时读取电量数据，结合场馆按时/按电量计费模式进行扣费。
安全监控： 实时监测功率，发现设备异常发热或过载时自动保护。
技术优势：该设备支持 WiFi 2.4G 直连，无需网关，设备联网即用；接口基于 HTTP 协议，兼容任意后端语言（Java, Python, PHP, Node.js 等）。
二、 对接架构图
graph LR
User[用户端 App/小程序] --> Cloud[共享场馆业务云服务器]
subgraph ThingBoot [芯步云平台]
API[开放 HTTP API]
MQ[消息推送服务]
end
subgraph Device_Local [场馆现场]
Device[智能通断器 AC3-10A 计量版]
Light[照明灯具/场馆电源]
end
Cloud -- 2.下发指令/获取状态 --> API
Cloud -- 3.订阅设备上报 --> MQ
MQ -- 4.推送状态/电量 --> Cloud
Cloud -- 1.生成签名/鉴权 --> Cloud
Device -- WiFi连接 --> ThingBoot
Device -- 继电器控制 --> Light三、 对接准备与配置
在开发前，需要在芯步开放平台完成以下准备工作
注册开发者账号：登录芯步开放平台。
获取凭证
AppId：应用的唯一标识。AppKey：用于生成接口签名（Sign）的密钥。
添加设备
在控制台中通配添加“智能通断器AC3-10A计量版”（型号：UNI-TDQ-AC3-10A-P）。
记录下设备的唯一标识：
DeviceId（即 MAC 地址或设备 ID）。
配置事件推送 URL（关键步骤） ：
在平台设置
Callback URL指向你的服务器地址（例如：https://yourdomain.com/api/yooyo/callback）。这一步是为了让芯步云主动推送电量和状态变更，避免软件项目频繁轮询。
四、 核心技术实现步骤
1. 生成动态签名 (Authentication)
芯步接口通过 sign 参数进行鉴权，规则通常是将 AppId、DeviceId、Timestamp 结合 AppKey 进行 MD5 或 HMAC-SHA256 加密。
示例逻辑：
2. 下发控制指令 (下行业务)
需求场景：用户在小程序点击“开灯”，后台需要调用芯步的接口控制继电器闭合。
请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求体 JSON (关键参数) ：
结合场馆业务的逻辑
下单成功 -> 开灯：用户支付成功后，后端立即发送
{"power":1}指令。预约时间段结束 -> 关灯：定时任务触发，发送
{"power":0}指令。紧急情况：调用
point或power命令实现先断后通或复位。
3. 接收状态反馈 (上行业务 - 核心难点)
为了知道设备是否真的开了，或者实时功率是多少，需要处理芯步云推送到你服务器的回调数据。
数据接收 (Webhook)当设备状态变化或定时上报时，芯步云会向你的 Callback URL 发送 POST 请求。
数据解析示例
业务处理
实时计费：将
electricity存入数据库，作为能耗账单依据。异常检测：若检测到
power > 2500W（如果灯具功率小，可能是租客私接大功率电器），可以触发保护逻辑自动关断。心跳维护：若长时间未收到心跳，判定设备离线，将该场馆标记为“设备维护中”，防止用户下单后无法开灯。
五、 共享场馆业务场景
第一种场景：自助预约计时模式
用户操作：小程序下单购买 2 小时照明服务。
系统动作：订单生成 -> 调用接口
power=1-> 数据库记录start_time。中途：后台定时拉取或接收推送的
metering数据，用于后台大屏展示“实时能耗”。结束：倒计时结束 -> 调用接口
power=0-> 根据实际使用时长（或电量）扣费。
第二种场景：签到/占座模式
利用通断器的通断逻辑，结合功率计量做“防占座”逻辑：
开灯：用户扫码成功，灯亮。
离开现场时检测：软件项目端监听回调消息，如果连续 10 分钟检测到
power = 0（比如用户关了灯但没点结束）且current = 0，系统自动触发“离开现场时确认”，释放场馆资源。
第三种场景：能耗统计看板
对于场馆运营方，通过聚合所有通断器上报的 metering 数据，可以生成报表：
日/周/月用电趋势图：发现哪些时段灯光浪费严重，调整自动关灯策略。
碳排放数据：用于展示给 C 端用户，提高品牌环保形象。
六、 常见问题与处理
设备离线怎么办？
原因：场馆 WiFi 信号弱或不稳定。
方案：通断器支持设置 5 组 WiFi 。施工时配置场馆专用 2.4G 信号放大器。软件项目层需设计“离线状态校验”接口，下单前
Ping设备状态，若离线则禁止下单并提醒工作人员。
计量数据的即时性
电量数据上报存在一定延迟（通常 1-5 分钟）。对于实时性要求比较高的按秒计费场景，采用“按功率*时间”的预计算模式，在结束时拉取最终
electricity做最终修正，避免延迟导致的计费偏差。
私有化部署
如果场馆对数据安全要求比较高（如政企场馆），芯步设备支持 私有化部署。此时 API 地址需替换为自建服务器的 IP，而非
api.thingboot.com，设备数据仅在内网传输。
七、 总结
将芯步 AC3-10A 计量版对接共享场馆系统，本质上是 “业务逻辑（订单/计费）” 与 “硬件逻辑（通断/计量）” 的数据交换。利用芯步标准化的 HTTP 接口和消息推送机制，开发者无需关注底层复杂的电气协议，只需关注签名安全、回调接收以及业务状态的映射（如订单状态0/1映射为power 0/1），即可快速实现软硬件一体化的智慧照明管理。