麦田 协议接入
ZenovaConnect 通过 麦田光伏逆变器 API (maitian-yun.com) 对接 麦田 设备，统一字段后推到你的通道。
✓ 已对接
对接详情
- API 来源
- 麦田光伏逆变器 API (maitian-yun.com)
- 类别
- 逆变器
- 认证方式
- api-key
- 数据精度
- 5min
- 下行控制
- 不支持
- 申请接入
- 2024-Q4
- 上线时间
- 2024-Q4
实际接入经验
麦田能源云平台(maitian-yun.com)对外开放的逆变器 API。鉴权简单——单一 api-key 走 header, 没有签名,适合快速接入。 字段返回风格采用统一的「name + variable + unit + value」对象列表,而不是嵌套结构—— 所有参数(包括 PV1Volt 到 PV18Volt 这类按编号扩展的字段)都在同一个 array 里平铺。我们 在接入侧按 variable 名做映射。 支持的设备很多 MPPT 路数(实测一个 R100-G2 机型返回了 18 路 PV 电压电流)。这对组串式 电站很有用——可以做到组串级监控告警,而不是只到逆变器级。 实时数据频次 5 分钟。提供电站、逆变器、设备列表、历史数据、错误码字典等接口。
字段映射
| 厂商字段 | BaseData 字段 | 说明 |
|---|---|---|
| stationId | PlantId | 电站 ID |
| deviceSn | InverterSN | 设备序列号 |
| todayYield | EDay | kW(注:文档单位标 kW,实为 kWh) |
| generation | ETotal | kWh · 累计发电量 |
| pvPower | PowerDCInputTotal | kW · 总光伏输入功率 |
| generationPower | PowerACOutputActive | kW · 输出有功功率 |
| pv{N}Volt / pv{N}Current | UDC1..N, IDC1..N | V/A · 多路 MPPT(实测 18 路) |
| RVolt, SVolt, TVolt | UAC1, UAC2, UAC3 | V · R/S/T 三相 |
| RCurrent, SCurrent, TCurrent | IAC1, IAC2, IAC3 | A · 三相分相 |
| RFreq, SFreq, TFreq | FrqAC | Hz · 三相频率(取主相) |
| invTemperation | Temperature | ℃ · 逆变器内部温度 |
| currentFault | AlertArray | 当前错误码 · 配合错误码字典 |
| runningState | (状态字段) | 数值状态码 · 含义见文档 |
接入坑点
- 字段单位标注不一致:todayYield 文档标 kW 但实际是 kWh——单位校验需要按 variable 名打补丁
- 字段命名兼容性:同一 R100-G2 机型可能存在「pv11Current」前置空格(' pv11Current') 这种脏数据,解析器需要 trim
- MPPT 路数最多 18 路(可能更多),需要 BaseData 扩展字段或采用编号化字段命名
- 错误码字典通过单独接口拉取(getErrorCodes),需要缓存和定期更新
- 无显式 token 过期机制,但 api-key 泄漏没有自动撤销渠道,需在我们侧做凭据轮换流程
✓ ZENOVACONNECT 已接入
生产环境对接自 2024-Q4 · API 来源 麦田光伏逆变器 API (maitian-yun.com)