昱能 协议接入
ZenovaConnect 通过 APsystems OpenAPI v1.6 对接 昱能 设备,统一字段后推到你的通道。
✓ 已对接
对接详情
- API 来源
- APsystems OpenAPI v1.6
- 类别
- 逆变器
- 认证方式
- api-key
- 数据精度
- 5min
- 下行控制
- 不支持
- 申请接入
- 2024-Q4
- 上线时间
- 2024-Q4
组件级 / 微逆数据
实际接入经验
Apsystems OpenAPI v1.6,英文文档。HmacSHA256/SHA1 五头签名(timestamp + nonce + access_key + secret_key + signed body),签名机制本身比较稳健。 无 5 分钟 endpoint——只有 hourly / daily / monthly / yearly 聚合粒度。监控类客户需要 自己做插值或换厂商。 账号长期不用(6 个月)会被关闭,凭据轮换需要主动 ping。
字段映射
| 厂商字段 | BaseData 字段 | 说明 |
|---|---|---|
| systemId | PlantId | 系统 ID |
| ecuId | InverterSN | ECU 即 micro-inverter 网关 |
| energyDay | EDay | kWh · hourly 聚合 |
| energyTotal | ETotal | kWh |
| power | PowerACOutputActive | W · hourly 平均 |
| temperature | Temperature | 摄氏度 |
| alerts | AlertArray | code + message |
接入坑点
- 无 5 分钟 endpoint,实时性最细 hourly,监控类客户接入前需对齐预期
- 账号 6 个月不用会被关闭,需要主动定期 ping API 保活
- ECU(micro-inverter 网关)概念与传统逆变器不同,需要单独建模
- 签名 5 头比较复杂,首次接入需要仔细 debug signature mismatch
✓ ZENOVACONNECT 已接入
生产环境对接自 2024-Q4 · API 来源 APsystems OpenAPI v1.6