DB53 T1027-2021 重点用能单位能耗在线监测平台数据接口规范.pdf
《DB53 T1027-2021 重点用能单位能耗在线监测平台数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB53 T1027-2021 重点用能单位能耗在线监测平台数据接口规范.pdf(64页珍藏版)》请在麦多课文档分享上搜索。
1、 DB53/T 10272021 重点用能单位能耗在线监测平台 数据接口规范 2021 - 04 - 08 发布 2021 - 07 - 08 实施 ICS 35.020 L 73 云南省地方标准 云南省市场监督管理局 发布 DB53/T 10272021 I 前 言 本文件按照GB/T 1.1 2020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定 起草。 本标准由云南省计量测试技术研究院、云南省节能监察中心提出。 本文件由云南省节能标准化技术委员会(YNTC11)归口。 本文件由云南省计量测试技术研究院、云南省节能监察中心、昆明理工大学起草。 本文件主要起草人:杨波、朱道飞、普
2、麟、徐万成、周晓春、吴佩林、陈雪雷、吴玉鲲 、陈丹晖、 李志娟 、尹建川、孙晓明。 DB53/T 10272021 1 重点用能单位能耗在线监测平台数据接口规范 1 范围 本文件确立了重点用能单位与省级平台数据交换相关术语与定义、数据接口授权、数据接口规范都 能内容。 本文件适用于重点用能单位与省级平台数据交换,数据交换内容包括重点用能单位基本信息、能源 计量器具信息、计量数据、能耗统计数据、能效指标数据等。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 重点用能单位 指年综合能源消费总量一万吨标准煤以上(含一万吨)的用能单位或国务院有关
3、部门、云南省人民 政府管理节能工作的部门指定的年综合能源消费总量五千吨标准煤以上(含五千吨)、不满一万吨标准 煤的用能单位。 3.2 省级平台 省级平台(重点用能单位能耗在线监测平台)是部署在省级节能相关部门,接收、存储、汇总、分 析本地内重点用能单位能耗在线监测数据,为本地相关政府部门、重点用能单位提供服务的系统。 3.3 端系统 对重点用能单位能源转换、输配、利用和回收实施动态监测和管理的信息系统,实现数据采集、分 析、汇总、上传等功能。 3.4 JSON JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。 它基于ECMAScript(欧洲计算机
4、协 会制定的js规范)的一个子集,采用完全独立于编程语言的文本格式来存储和表示数据。 3.5 XML XML(Extensible Markup Language),可扩展标记语言,标准 通用标记语言的子集,是一种用于标 记电子文件使其具有结构性的标记语言。它可以用来标记数据、定义数据类型,是一种允许用户对自己 的标记语言进行定义的源语言。它被设计用于存储和传输数据。 DB53/T 10272021 2 3.6 AK AK(Access Key)是省级平台生成的一串字符串,用作端系统进行请求的一个令牌,当端系统申请AK 后,省级平台生成一个AK(Token),并将此AK返回给端系统,端系统只需
5、带上这个AK来请求接口,而无需 带上用户名和密码。 3.7 SM4 算法 SMS4分组加密算法是中国无线标准中使用的分组加密算法, 在2012年已经被国家商用密码管理局确 定为国家密码行业标准,标准编号GM/T 0002-2012并且改名为SM4算法,与SM2椭圆曲线公钥密码算法, SM3密码杂凑算法共同作为国家密码的行业标准,在我国密码行业中有着极其重要的位置。 SMS4算法的分组长度为128bit,密钥长度也是128bit。加解密算法均采用32轮非平衡Feistel迭代 结构,该结构最先出现在分组密码LOKI的密钥扩展算法中。SMS4通过32轮非线性迭代后加上一个反序变 换,这样只需要解密
6、密钥是加密密钥的逆序,就能使得解密算法与加密算法保持一致。SMS4加解密算法 的结构完全相同,只是在使用轮密钥时解密密钥是加密密钥的逆序。 3.8 PIN PIN(Personal Identi fication Number),端系统使用该个人鉴别码访问省级平台。 3.9 PINBLOCK 对PIN进行加密时,由于PIN长度一般不符合加密算法的固定分组长度要求,对PIN进行填充,使之达 到一个分组的长度,填充后的PIN的分组数据块,称之为PINBLOCK。 3.10 IV IV( Initialization Vector),初始化向量或译初向量,又称初始变量(Starting Variab
7、le,缩写为 SV),是一个固定长度的输入值。一般的使用上会要求它是随机数或拟随机数(pseudorandom)。 4 数据接口授权 为保证数据在网络传输过程中的安全,接口采用省级平台交互身份认证的令牌AK进行接口授权。 5 数据接口规范 5.1 数据交换流程 端系统数据交换流程如图1所示,具体分为以下几步: a) 端系统接入申请:向省级平台提交数据接入申请,在省级平台注册端系统,获得后续与省级平 台连接和交换数据的 AK; b) 平台版本校验:端系统与省级平台进行当前版本一致性校验。校验不通过时,端系统应先从省 级平台下载基础数据并更新本地数据,确保端系统与省级平台当前版本一致,才能进行后续
8、数 据交换; c) 平台基础配置地址更新:省级平台的平台服务信息更改后,端系统应支持重新获取平台基础配 置信息并更新相关配置; d) 平台基础数据下载:平台基础数据变更后,端系统应支持重新下载平台基础数据; DB53/T 10272021 3 e) 重点用能单位数据上传:实现重点用能单位基础数据、采集配置数据和采集数据的上传。 端系统 安装部署 端系统获取 AK 获取失败 更新配置地址 返回码验证 下载失败 平台版本校验 用能单位基础数据上传 返回码验证 用能单位采集配置数据上传 返回码验证 用能单位采集数据上传 返回码验证 完成 版本变更 版本无变更 本地保存处理 下载完成 上传成功 上传失
9、败 上传失败 上传成功 上传失败 上传成功 返回码验证 获取成功 端系统注册基础数据下载 端系统注册申请 返回码验证申请失败 申请成功 端系统注册申请 返回码验证申请失败 申请成功 下载基础数据 配置地址变更 是 否 端系统接入申请 平台版本校验 重点用能单位数据上传 平台基础配置地址更新 平台基础配置数据下载 图1 端系统数据交换流程图 5.2 接口调用规范 所有接口以http方式,通过post请求提供调用服务,调用方式如下: http:/server/service?params 参数含义: server :提供接口的服务器信息 (地址和端口 ); DB53/T 10272021 4 se
10、rvice:调用接口所提供的服务名称; params:调用接口服务所需要的参数,通过post请求传送。 调用示例: http请求post方式: http:/localhost:81/ng-dc-s/termReg 服务器(端口和地址): lo calhost:81 服务名称:ng-dc-s/termReg 所需参数: enterpriseCode:913300005739XXXX3F,/统一社会信用代码 region:530000/行政区划代码,具体到县级 5.3 数据交换格式 重点用能单位端系统与省级平台数据交换格式采用JSON。省级平台返回响应码见附表A.1所示。 6 数据交换接口 6.1
11、 数据交换接口字段要求 下述数据交换接口中,使用“*”标注的字段均为必填字段。 6.2 端系统接入管理 6.2.1 端系统申请工作密钥 端系统向省级平台进行端系统工作密钥申请,省级平台返回工作密钥,用于后续接口交换安全。 报文接口示例,见附表B.1端系统申请工作密钥报文接口示例表。 报文字段规则,见表1。 表1 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 secretKey 工作密钥 32 首次申请工作密钥为空 6.2.2 端系统注册基础数据下载 端系统申请并成功获得工作密钥后,在进行端系统注册申请前,应选择从省级平台下载行政
12、区划代 码、行业编码及重点用能单位类型编码等基础数据。 报文接口示例,见附表B.2端系统注册基础数据下载报文接口示例表。 报文字段规则,见表2。 DB53/T 10272021 5 表2 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 itemIndex 基础数据表编码 *,1:行政区划代码 2:行业编码 16:重点用能单位类型编码 3 data 平台基础数据 省级平台返回的数据 6.2.3 端系统注册申请 端系统下载注册基础数据后,端系统项省级平台申请注册,审核通过后,重点用能单位端系统可接 入平台,并使用数据接口。 报文接口示
13、例,见附表B.3端系统注册申请报文接口示例表。 报文字段规则,见表3。 表3 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 isorg 是否是公共机构 1 *,0:不是;1:是 3 password 省级平台访问密码 64 * 4 cmpName 单位名称 30 * 5 address 地址 50 * 6 zipCode 邮编 6 7 corporationName 法人代表 30 * 8 regionCode 行政区划代码 *,具体到县级 9 license 营业执照 400k *,使用Base64编码 10 organiza
14、tion 组织结构图 400k 使用Base64编码 11 registerAddress 注册地址 50 * 12 registerDate 注册日期 *,yyyy-MM-dd 13 registerPrincipa l 注册资金 10 *,单位为万元 14 typeCode 单位类型 50 *,参考用能单位类型编码表 15 industryCode 行业编码 10 *,参考行业编码表 16 fieldCode 领域编码 3 *,100:工业;200:交通运输、仓储 和邮政业;300:住宿和 餐饮业;400: 批发和零售业;500:教育;600:其他 DB53/T 10272021 6 表
15、3(续) 序号 字段 名称 长度 备注 17 energyConsumeLev el 重点用能单位耗能级 别 1 *,1:5000 吨以下 2:500010000 吨 3:1万-10 万吨 4:10万-50 万吨 5;50万-300 万吨 6:300万吨以上 18 center 是否央企 1 *,0:不是;1:是 19 jgzh 是否能源加工转换类 重点用能单位 1 *,0:不是;1:是 20 latitude 厂址中心纬度 25 * 21 longitude 厂址中心经度 25 * 22 phone 联系电话(法人) 13 * 23 fax 传真 13 24 email 电子邮箱(法人) 3
16、0 25 url 用能单位网站地址 30 26 productionLine 主要生产线名称 255 * 27 leadingProduct 主导产品 100 * 28 groupName 集团名称 50 央企需要填写 29 groupAddress 集团地址 50 央企需要填写 30 orgType 机构类型 3 *,01:国家机关 02:事业单位 021:教育事业 022:科技事业 023:文化事业 024:卫生事业 025:体育事业 026:其它 03:团体组织 31 orgCode 组织机构代码 9 remark 备注 255 6.2.4 端系统修改平台访问密码 端系统向省平台申请注册
17、,并通过审核后,省级平台允许端系统根据业务要求,对端系统访问省级 平台的访问进行修改。 报文接口示例,见附表B.4端系统修改平台访问密码报文接口示例表。 报文字段规则,见表4。 DB53/T 10272021 7 表4 报文字段规则表 序号 字段 名称 长度 备注 1 dataIndex 企业注册记录索引号 64 * 2 enterpriseCode 统一社会信用代码 18 * 3 currentPassword 省级平台原访问密码 64 * 4 newPassword 省级平台新访问密码 64 * 6.2.5 端系统获取 AK 端系统注册申请通过审核,可获取到访问省级平台的AK及重点用能单位
18、数据交换时间。 报文接口示例,见附表B.5端系统获取AK报文接口示例表。 报文字段规则,见表5。 表5 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 password 省级平台访问密码 64 * 3 akExpiresIn 到期时间 yyyy-MM-dd HH:mm:ss SSS 4 akValidAt 启用时间 yyyy-MM-dd HH:mm:ss SSS 5 enterpriseUploadTime 数据交换时间段 HH:mm:ss 6 platformURL 平台版本校验地址 100 7 token 访问省级平台AK 2
19、30 6.3 平台版本校验 省级平台的平台服务信息或基础数据更改后,版本信息会进行更新。端系统可基于此接口确认省级 平台最新版本信息,确认端系统本地基础信息是否需要进行更新。 报文接口示例,见附表B.6平台版本校验报文接口示例表。 报文字段规则,见表6。 表6 报文字段规则 序号 字段 名称 长度 备注 1 AK 访问省级平台AK 230 * 2 enterpriseCode 统一社会信用代码 18 * 3 dicVersion 平台基础数据版本 10 4 regVersion 平台基础配置版本 10 5 loadPlatformDataURL 平台基础配置查询地址 100 6 modifyD
20、escription 版本变更简述 255 6.4 平台基础配置地址更新 省级平台的平台服务信息或基础数据更改后, 端系统基于版本信息, 可重新获取平台基础配置信息。 平台基础配置信息包含,但不限于以下信息: a) 基础数据下载地址:用于接入端系统基础数据下载; DB53/T 10272021 8 b) 重点用能单位基础信息配置上传地址:用于重点用能单位基础信息上传至省级平台; c) 采集数据上传地址:用于重点用能单位采集数据上传至省级平台; d) 重点用能单位基础信息配置下载地址:用于从省级平台下载重点用能单位基础信息; e) 采集数据下载地址:用于从省级平台下载重点用能单位采集数据。 能源
21、资源数据交换地址:用于重点用能单位采集数据上传至省级平台: a) 报文接口示例,见附表 B.7 平台基础配置地址更新报文接口示例表; b) 报文字段规则,见表 7。 表7 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 enterpriseDataDownloadURL 耗数据下载地址 100 3 enterpriseDataURL 能耗数据交换地址 100 4 enterpriseInfoDownloadURL 基础信息配置下载地址 100 5 enterpriseInfoURL 基础信息配置交换地址 100 6 loadBas
22、eDataURL 基础数据下载地址 100 6.5 平台基础数据下载 省级平台的基础数据更改后,端系统比较本地的基础数据版本信息与省级平台不一致,应重新下载 基础数据。 报文接口示例,见附表B.8平台基础数据下载报文接口示例表。 报文字段规则,见表8。 表8 报文字段规则表 序号 字段 名称 长度 备注 1 enterpriseCode 统一社会信用代码 18 * 2 itemIndex 基础数据表编码 *,1:行政区划代码 2:行业编码 3:生产工序编码 4:工序单元编码 5:用能设备编码 6:数据采集来源类型编码 7:采集数据类型编码 8:能源品种编码计量单位及精度 9:耗能工质编码计量单
23、位及精度 10:非能源类产品及计量单位(包含平 台预定义编码及重点用能单位自定义 编码) 11:能效指标编码及计量单位 12:经营指标编码及计量单位 13:其它数据编码 DB53/T 10272021 9 表 8(续) 序号 字段 名称 长度 备注 14:能源用途编码 15:计量器具编码 16:重点用能单位类型编码 17:重点用能设备分类编码 3 data 平台基础数据 省级平台返回的数据 6.6 重点用能单位能耗数据交换 6.6.1 重点用能单位基础数据上传 6.6.1.1 重点用能单位联系人信息 端系统根据省平台要求上传重点用能单位联系人姓名、电话、所在部门、职位、传真、邮箱等信息: 报文
24、接口示例,见附表B.9新增重点用能单位联系人报文接口示例表; 报文字段规则,见表9。 表9 报文字段规则表 序号 字段 名称 长度 备注 1 regVersion 平台服务版本 10 * 2 dicVersion 基础数据版本 10 * 3 enterpriseCode 统一社会信用代码 18 * 4 contacterName 姓名 15 * 5 phone 电话 13 * 6 dept 所在部门 20 * 7 job 职位、或者岗位 15 8 fax 传真 13 9 email 邮件 30 10 remark 备注 255 11 dataIndex 记录索引号 64 由端系统保存 6.6.
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB53 T1027-2021 重点用能单位能耗在线监测平台数据接口规范 T1027 2021 重点 单位 能耗 在线 监测 平台 数据 接口 规范
