ICS 35.020 L 73 云 南 省 地 方 标 准 DB53/T 1027—2021 重点用能单位能耗在线监测平台 数据接口规范 2021 - 04 - 08 发布 云南省市场监督管理局 2021 - 07 - 08 实施 发 布 DB53/T 1027—2021 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本标准由云南省计量测试技术研究院、云南省节能监察中心提出。 本文件由云南省节能标准化技术委员会（YNTC11）归口。 本文件由云南省计量测试技术研究院、云南省节能监察中心、昆明理工大学起草。 本文件主要起草人：杨波、朱道飞、普麟、徐万成、周晓春、吴佩林、陈雪雷、吴玉鲲 、陈丹晖、 李志娟 、尹建川、孙晓明。 I DB53/T 1027—2021 重点用能单位能耗在线监测平台数据接口规范 1 范围 本文件确立了重点用能单位与省级平台数据交换相关术语与定义、数据接口授权、数据接口规范都 能内容。 本文件适用于重点用能单位与省级平台数据交换，数据交换内容包括重点用能单位基本信息、能源 计量器具信息、计量数据、能耗统计数据、能效指标数据等。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 重点用能单位 指年综合能源消费总量一万吨标准煤以上（含一万吨）的用能单位或国务院有关部门、云南省人民 政府管理节能工作的部门指定的年综合能源消费总量五千吨标准煤以上（含五千吨）、不满一万吨标准 煤的用能单位。 3.2 省级平台 省级平台（重点用能单位能耗在线监测平台）是部署在省级节能相关部门，接收、存储、汇总、分 析本地内重点用能单位能耗在线监测数据，为本地相关政府部门、重点用能单位提供服务的系统。 3.3 端系统 对重点用能单位能源转换、输配、利用和回收实施动态监测和管理的信息系统，实现数据采集、分 析、汇总、上传等功能。 3.4 JSON JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。它基于ECMAScript(欧洲计算机协 会制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。 3.5 XML XML(Extensible Markup Language)，可扩展标记语言，标准通用标记语言的子集，是一种用于标 记电子文件使其具有结构性的标记语言。它可以用来标记数据、定义数据类型，是一种允许用户对自己 的标记语言进行定义的源语言。它被设计用于存储和传输数据。 1 DB53/T 1027—2021 3.6 AK AK(Access Key)是省级平台生成的一串字符串，用作端系统进行请求的一个令牌，当端系统申请AK 后，省级平台生成一个AK(Token),并将此AK返回给端系统，端系统只需带上这个AK来请求接口，而无需 带上用户名和密码。 3.7 SM4 算法 SMS4分组加密算法是中国无线标准中使用的分组加密算法，在2012年已经被国家商用密码管理局确 定为国家密码行业标准，标准编号GM/T 0002-2012并且改名为SM4算法，与SM2椭圆曲线公钥密码算法， SM3密码杂凑算法共同作为国家密码的行业标准，在我国密码行业中有着极其重要的位置。 SMS4算法的分组长度为128bit，密钥长度也是128bit。加解密算法均采用32轮非平衡Feistel迭代 结构，该结构最先出现在分组密码LOKI的密钥扩展算法中。SMS4通过32轮非线性迭代后加上一个反序变 换，这样只需要解密密钥是加密密钥的逆序，就能使得解密算法与加密算法保持一致。SMS4加解密算法 的结构完全相同，只是在使用轮密钥时解密密钥是加密密钥的逆序。 3.8 PIN PIN（Personal Identification Number），端系统使用该个人鉴别码访问省级平台。 3.9 PINBLOCK 对PIN进行加密时，由于PIN长度一般不符合加密算法的固定分组长度要求，对PIN进行填充,使之达 到一个分组的长度，填充后的PIN的分组数据块,称之为PINBLOCK。 3.10 IV IV（Initialization Vector），初始化向量或译初向量，又称初始变量（Starting Variable，缩写为 SV），是一个固定长度的输入值。一般的使用上会要求它是随机数或拟随机数（pseudorandom）。 4 数据接口授权 为保证数据在网络传输过程中的安全,接口采用省级平台交互身份认证的令牌AK进行接口授权。 5 数据接口规范 5.1 数据交换流程 端系统数据交换流程如图1所示，具体分为以下几步： a) 端系统接入申请：向省级平台提交数据接入申请，在省级平台注册端系统，获得后续与省级平 台连接和交换数据的 AK； b) 平台版本校验：端系统与省级平台进行当前版本一致性校验。校验不通过时，端系统应先从省 级平台下载基础数据并更新本地数据，确保端系统与省级平台当前版本一致，才能进行后续数 据交换； c) 平台基础配置地址更新：省级平台的平台服务信息更改后，端系统应支持重新获取平台基础配 置信息并更新相关配置； d) 平台基础数据下载：平台基础数据变更后，端系统应支持重新下载平台基础数据； 2 DB53/T 1027—2021 e) 重点用能单位数据上传：实现重点用能单位基础数据、采集配置数据和采集数据的上传。 端系统 安装部署 端系统注册申请 申请失败 返回码验证 申请成功 端系统注册基础数据下载 端系统注册申请 端系统接入申请 申请失败 返回码验证 申请成功 端系统获取AK 返回码验证 获取失败 获取成功 平台版本校验 平台版本校验 版本变更 版本无变更 配置地址变更 用能单位基础数据上传 上传失败 是 平台基础配置地址更新 否 返回码验证 更新配置地址 上传成功 下载基础数据 用能单位采集配置数据上传 下载失败 重点用能单位数据上传 上传失败 返回码验证 返回码验证 平台基础配置数据下载 下载完成 上传成功 本地保存处理 用能单位采集数据上传 返回码验证 上传失败 上传成功 完成 图1 5.2 端系统数据交换流程图 接口调用规范 所有接口以http方式，通过post请求提供调用服务，调用方式如下： http://[server]/[service]?[params] 参数含义： server ：提供接口的服务器信息(地址和端口)； 3 DB53/T 1027—2021 service：调用接口所提供的服务名称； params:调用接口服务所需要的参数,通过post请求传送。 调用示例: http请求post方式： http://localhost:81/ng-dc-s/termReg 服务器(端口和地址)： localhost:81 服务名称：ng-dc-s/termReg 所需参数： { "enterpriseCode":"913300005739XXXX3F",//统一社会信用代码 "region":"530000"//行政区划代码，具体到县级 } 5.3 数据交换格式 重点用能单位端系统与省级平台数据交换格式采用JSON。省级平台返回响应码见附表A.1所示。 6 数据交换接口 6.1 数据交换接口字段要求 下述数据交换接口中，使用“*”标注的字段均为必填字段。 6.2 端系统接入管理 6.2.1 端系统申请工作密钥 端系统向省级平台进行端系统工作密钥申请，省级平台返回工作密钥，用于后续接口交换安全。 报文接口示例，见附表B.1端系统申请工作密钥报文接口示例表。 报文字段规则，见表1。 表1 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 secretKey 工作密钥 32 首次申请工作密钥为空 6.2.2 端系统注册基础数据下载 端系统申请并成功获得工作密钥后，在进行端系统注册申请前，应选择从省级平台下载行政区划代 码、行业编码及重点用能单位类型编码等基础数据。 报文接口示例，见附表B.2端系统注册基础数据下载报文接口示例表。 报文字段规则，见表2。 4 DB53/T 1027—2021 表2 序号 字段 报文字段规则表 名称 长度 1 enterpriseCode 统一社会信用代码 2 itemIndex 基础数据表编码 备注 18 * *，1：行政区划代码 2：行业编码 16：重点用能单位类型编码 3 data 6.2.3 平台基础数据 省级平台返回的数据 端系统注册申请 端系统下载注册基础数据后，端系统项省级平台申请注册，审核通过后，重点用能单位端系统可接 入平台，并使用数据接口。 报文接口示例，见附表B.3端系统注册申请报文接口示例表。 报文字段规则，见表3。 表3 序号 字段 报文字段规则表 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 isorg 是否是公共机构 1 3 password 省级平台访问密码 64 * 4 cmpName 单位名称 30 * 5 address 地址 50 * 6 zipCode 邮编 6 7 corporationName 法人代表 30 8 regionCode 行政区划代码 9 license 营业执照 400k *，使用 Base64 编码 10 organization 组织结构图 400k 使用 Base64 编码 11 registerAddress 注册地址 50 12 registerDate 注册日期 13 registerPrincipa 注册资金 10 *，单位为万元 *，0：不是；1：是 * *，具体到县级 * *，yyyy-MM-dd l 14 typeCode 单位类型 50 *，参考用能单位类型编码表 15 industryCode 行业编码 10 *，参考行业编码表 16 fieldCode 领域编码 3 *，100：工业；200：交通运输、仓储 和邮政业；300：住宿和 餐饮业；400： 批发和零售业；500：教育；600：其他 5 DB53/T 1027—2021 表 3（续） 序号 字段 名称 长度 17 energyConsumeLev 重点用能单位耗能级 el