API 更新日志
追踪 API 版本变更、新功能和废弃通知
版本生命周期策略
废弃版本将在通知后 6 个月内提供迁移支持，12 个月后正式下线。新增字段不算破坏性变更。详见 API 版本管理策略。
v2.1.0
最新
2026-03-01
计划中
批量调度控制 API
计划于 V1.2 版本支持一次性向 1000+ 设备下发调度指令。
新增
电网参数数据
遥测接口新增 grid 字段，包含电压、频率、无功功率、功率因数。
改进
响应时间优化
实时遥测 API P95 响应时间从 800ms 降至 300ms。
废弃
/v1/telemetry 端点
将于 2026-06-01 下线，请迁移至 /v2/telemetry。 查看迁移指南 →
v2.0.0
2026-01-15
⚠️ 重大版本更新
V2 API 包含不兼容变更，请查看迁移指南后再升级。
新增
统一遥测接口
所有设备类型使用统一的 /v2/telemetry 接口，通过 capabilities 字段区分可用数据。
计划中
Webhook 事件推送
计划于 V1.1 版本支持 device.alert 等事件类型的实时推送。
破坏性变更
响应格式变更
所有响应统一包装为 { success, data, error } 格式。
破坏性变更
认证方式变更
废弃 Basic Auth，统一使用 Bearer Token。
v1.2.0
2025-11-01
新增
告警管理 API
新增告警查询、确认、统计接口。
改进
分页参数标准化
所有列表接口统一使用 page/pageSize 参数。
v1.1.0
2025-09-01
新增
历史数据查询
支持查询最近 30 天的历史遥测数据。
v1.0.0
2025-06-01
发布
API Portal 正式上线
首个公开版本，支持站点、设备、实时遥测查询。