新耀云 协议接入
ZenovaConnect 通过 新耀云平台三方接口 对接 新耀云 设备，统一字段后推到你的通道。
🚧 对接中
对接详情
- API 来源
- 新耀云平台三方接口
- 类别
- 逆变器
- 认证方式
- signed-request
- 数据精度
- 5min
- 下行控制
- 不支持
- 申请接入
- 2024-Q4
已拿到三方接口文档,对接进行中
实际接入经验
新耀云光伏云平台 Open API。已拿到完整接口文档,对接进行中。 鉴权采用 MD5 签名:sign = MD5(key + appid + timestamp),公共头三个字段 auth-cert-appid / auth-cert-timestamp / auth-cert-sign,timestamp 是 13 位毫秒,key 不在请求中传输—— 属于比较经典的 v1 风格签名,需要注意时钟漂移与重放窗口。 字段体系是「数据项 ID + 数值」模式:数据项以数字编码(162=功率、163=日发电量、160=累计 发电量等),客户端按 ID 列表请求,而不是按字段名。这是为了支持多设备类型(1 逆变器 / 2 汇流箱 / 3 气象站 / 15 电能表)和电表/逆变器双口径计量(01 逆变器计算 / 02 电表计算)。 告警接口是「批量查询所有未恢复告警」语义,需要轮询差分而不是事件订阅。
字段映射
| 厂商字段 | BaseData 字段 | 说明 |
|---|---|---|
| plantList.id | PlantId | 电站 ID |
| deviceSn | InverterSN | 设备序列号 |
| 数据项 162 | PowerACOutputActive | W · 当前功率 |
| 数据项 163 | EDay | kWh · 当日发电量 |
| 数据项 160 | ETotal | kWh · 累计发电量 |
| 数据项 17/18/19 | UDC1, UDC2, UDC3 | V · 输入电压 1-N(最多 32 路) |
| 数据项 33/34/35 | IDC1, IDC2, IDC3 | A · 输入电流 1-N |
| 三相输出频率 | FrqAC | Hz |
| 三相输出电压 | UAC1, UAC2, UAC3 | V · A/B/C 相 |
| 内部温度(数据项 1) | Temperature | ℃ |
| 告警代码 | AlertArray | 批量未恢复告警 · 需轮询差分 |
| deviceStatus | (状态字段) | 01 运行 / 02 检修 / 03 退役 / 04 未并网 |
接入坑点
- MD5 签名 v1 风格,对时钟漂移敏感——需要 NTP 同步与签名失败时的时间戳重试
- 数据项以数字 ID 标识(162/163/160 等),需要维护一份完整的 ID → BaseData 字段映射表,文档外的新 ID 可能临时出现
- 电表与逆变器双计量口径(01/02)在同一电站可能并存,聚合发电量需明确选取规则
- 告警走批量轮询「所有未恢复」语义而非事件流,需要在我们侧做差分检测出 new/recovered
- 多设备类型(逆变器/汇流箱/气象站/电能表)共享同一字段命名空间,接入时要按 deviceType 分支
⏳ ZENOVACONNECT 接入中
已获取 API 文档，接入实施中 · 来源 新耀云平台三方接口