悦享Solar 协议接入
ZenovaConnect 通过 悦享 Solar 数据转发接口 v2.0.0 对接 悦享Solar 设备，统一字段后推到你的通道。
🚧 对接中
对接详情
- API 来源
- 悦享 Solar 数据转发接口 v2.0.0
- 类别
- 逆变器
- 认证方式
- api-key
- 数据精度
- 5min
- 下行控制
- 不支持
- 申请接入
- 2024-Q4
已拿到数据转发接口说明书 v2.0.0
实际接入经验
悦享 Solar(上能电气)数据转发接口 v2.0.0(国内标准版,2024-11 发布)。我们已拿到完整接入 文档,正在对接中。 架构上比较特别:实时数据走「阿里云轻量消息队列 SMQ(原 MNS)」推送——三方系统作为消费者 定期从队列拉取数据,而不是被动接收 Webhook。这意味着接入侧需要部署 SMQ SDK 消费者 (Java/Python/Go 等)。 轻量级查询接口走 RESTful + HTTPS,请求头携带 sn-sign 令牌做鉴权,限流 30 req/min。 字段结构嵌套较深:顶层 Inverters 数组,每个逆变器内含 pv_mppt、pv_string、ac 多个子列表 (每个 MPPT 一个对象、每相一个对象),需要在 BaseData 侧做扁平化映射。
字段映射
| 厂商字段 | BaseData 字段 | 说明 |
|---|---|---|
| stationCode | PlantId | 电站编号 |
| Inverters[].isn | InverterSN | 逆变器序列号 |
| e_today | EDay | kWh · 日发电量 |
| e_total | ETotal | kWh · 累计发电量 |
| pac | PowerACOutputActive | W · 交流有功功率 |
| rac | PowerACOutputReactive | Var · 交流无功功率 |
| ac[].u | UAC1, UAC2, UAC3 | V · 三相分相电压(列表) |
| ac[].i | IAC1, IAC2, IAC3 | A · 三相分相电流(列表) |
| ac[].fre | FrqAC | Hz · 交流频率 |
| temp | Temperature | ℃ · 机内温度 |
| warning[].w | AlertArray | 告警代码数组 · 无告警码即恢复 |
| communStatus | (状态字段) | 1 在线 / 2 离线 / 4 无状态 |
接入坑点
- 实时数据走阿里云 SMQ 队列推送,不是 Webhook——接入侧需部署队列消费者并按 SMQ 流控策略消费
- 字段结构嵌套较深(Inverters[].pv_mppt[].u 等),BaseData 侧需要扁平化
- 告警机制采用「无告警码即视为恢复」模式,没有显式 recovery 事件,需要在内存中维护告警状态机
- 查询接口限流 30 req/min · 大规模电站列表分页查询需要节流
- 数据消息在队列中保留 4 天未消费即丢弃,消费侧 downtime 超过 4 天会有历史空洞
⏳ ZENOVACONNECT 接入中
已获取 API 文档，接入实施中 · 来源 悦享 Solar 数据转发接口 v2.0.0