ICS29.020 CCSK00 中华人民共和国国家标准 GB/T35031.5—2025 用户端能源管理系统 第5部分:应用侧接口规范 Customerenergymanagementsystem— Part5:Applictioninterfacespecification 2025-12-31发布 2026-07-01实施 国家市场监督管理总局 国家标准化管理委员会发布目 次 前言 Ⅴ ………………………………………………………………………………………………………… 引言 Ⅵ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语、定义和缩略语 1 ……………………………………………………………………………………… 3.1 术语和定义 1 ………………………………………………………………………………………… 3.2 缩略语 2 ……………………………………………………………………………………………… 4 应用侧接口API范围 2 …………………………………………………………………………………… 4.1 系统角色定义 2 ……………………………………………………………………………………… 4.2 数据交互流程 4 ……………………………………………………………………………………… 4.3 数据提供范围 4 ……………………………………………………………………………………… 5 接口调用与响应方式 4 …………………………………………………………………………………… 5.1 数据传输原则 4 ……………………………………………………………………………………… 5.2 请求头 4 ……………………………………………………………………………………………… 5.3 请求URL 5 ………………………………………………………………………………………… 5.4 返回码 5 ……………………………………………………………………………………………… 5.5 安全性说明 5 ………………………………………………………………………………………… 5.6 可扩展性说明 5 ……………………………………………………………………………………… 6 基本信息模型(Basic) 6 …………………………………………………………………………………… 6.1 基本信息模型图 6 …………………………………………………………………………………… 6.2 设备类(Category) 6 ………………………………………………………………………………… 6.3 用户端(Cems) 7 ……………………………………………………………………………………… 6.4 数据计数(DataCount) 8 ……………………………………………………………………………… 6.5 动态数据(DynamicData) 8 …………………………………………………………………………… 6.6 历史数据(HistoricData) 8 …………………………………………………………………………… 6.7 分页信息(Page) 8 …………………………………………………………………………………… 6.8 计量参数(Parameter) 8 ……………………………………………………………………………… 6.9 接入点(Point) 9 ……………………………………………………………………………………… 6.10 读数(Reading) 10 …………………………………………………………………………………… 6.11 简约设备类(SimpleCategory) 10 ………………………………………………………………… 6.12 简约接入点(SimplePoint) 10 ……………………………………………………………………… 6.13 简约统计接入点(SimpleStatisticPoint) 11 ………………………………………………………… 6.14 静态数据(StaticData) 11 …………………………………………………………………………… ⅠGB/T35031.5—2025 6.15 统计数据(StatisticData) 11 ………………………………………………………………………… 7 静态基本信息接口 12 ……………………………………………………………………………………… 7.1 获取用户端静态数据(GetCemsStaticData) 12 …………………………………………………… 7.2 获取用户端完整的静态数据(GetCemsFullStaticData) 13 ………………………………………… 7.3 获取用户端特定设备类的静态数据(GetCemsSpecCategoryStaticData) 15 ……………………… 7.4 获取接入点静态数据(GetPointStaticData) 15 …………………………………………………… 7.5 获取接入点完整的静态数据(GetPointFullStaticData) 17 ………………………………………… 7.6 获取接入点特定设备类的静态数据(GetPointSpecCategoryStaticData) 18 …………………… 8 动态实时信息接口 19 ……………………………………………………………………………………… 8.1 获取用户端动态实时数据(GetCemsDynamicData) 19 …………………………………………… 8.2 获取用户端完整的动态实时数据(GetCemsFullDynamicData) 20 ……………………………… 8.3 获取用户端特定设备类的动态实时数据(GetCemsSpecCategoryDynamicData) 20 …………… 8.4 获取接入点动态实时数据(GetPointDynamicData) 21 …………………………………………… 8.5 获取接入点完整的动态实时数据(GetPointFullDynamicData) 22 ……………………………… 8.6 获取接入点特定设备类的动态实时数据(GetPointSpecCategoryDynamicData) 23 …………… 9 历史数据信息接口 24 ……………………………………………………………………………………… 9.1 获取用户端历史数据(GetCemsHistoricData) 24 ………………………………………………… 9.2 获取用户端完整的历史数据(GetCemsFullHistoricData) 25 ……………………………………… 9.3 获取用户端特定设备类的历史数据(GetCemsSpecCategoryHistoricData) 26 …………………… 9.4 获取接入点历史数据(GetPointHistoricData) 27 ………………………………………………… 9.5 获取接入点完整的历史数据(GetPointFullHistoricData) 28 ……………………………………… 9.6 获取接入点特定设备类的历史数据(GetPointSpecCategoryHistoricData) 28 …………………… 10 汇总统计信息接口 29 …………………………………………………………………………………… 10.1 获取用户端统计数据(GetCemsStatisticData) 29 ………………………………………………… 10.2 获取用户端完整的统计数据(GetCemsFullStatisticData) 30 …………………………………… 10.3 获取用户端特定设备类的统计数据(GetCemsSpecCategoryStatisticData) 31 ………………… 10.4 获取接入点统计数据(GetPointStatisticData) 33 ………………………………………………… 10.5 获取接入点完整的统计数据(GetPointFullStatisticData) 34 …………………………………… 10.6 获取接入点特定设备类的统计数据(GetPointSpecCategoryStatisticData) 35 ………………… 附录A(资料性) CEMS应用侧接口的需求响应(DR)延展实例 36 ……………………………………… A.1 概述 36 ……………………………………………………………………………………………… A.2 DR基本信息模型 36 ………………………………………………………………………………… A.3 DR信息接口 39 ……………………………………………………………………………………… 附录B(资料性) CEMS应用侧接口的需量管理延展实例 42 …………………………………………… B.1 概述 42 ………………………………………………………………………………………………… B.2 需量管理基本信息 42 ………………………………………………………………………………… B.3 需量管理信息接口 43 ……………………………