DB35∕T 2000-2021 碳排放数据公共平台数据传输协议(福建省).pdf
《DB35∕T 2000-2021 碳排放数据公共平台数据传输协议(福建省).pdf》由会员分享,可在线阅读,更多相关《DB35∕T 2000-2021 碳排放数据公共平台数据传输协议(福建省).pdf(56页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、 ICS 35.020 CCS L 70 35 福建省地方标准 DB35/T 20002021 碳排放数据公共平台数据传输协议 Protocol for data communication of carbon emission data public platform 2021-08-17 发布 2021-11-17 实施福建省市场监督管理局 发 布DB35/T 20002021 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 平台架构.2 6 通讯协议.3 7 通讯架构.4 8 通讯接口.6 9 监测数据项编码.9 附录 A(规范性)参数
2、信息.10 附录 B(资料性)数据传输代码示例.20 附录 C(规范性)编码信息.33 参考文献.53 DB35/T 20002021 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省计量科学研究院提出。本文件由福建省信息化标准化技术委员会(SAFJ/TC 11)归口。本文件起草单位:福建省计量科学研究院、厦门奥普拓自控科技有限公司。本文件主要起草人:方仁桂、吴孟辉、褚丹雷、姚进辉、陆青、王智苑、陈为晶、林荣捷。DB35/T 20002021 1
3、 碳排放数据公共平台数据传输协议 1 范围 本文件规定了碳排放数据公共平台数据传输的平台架构、通讯协议、通讯架构、通讯接口和监测数据项编码。本文件适用于排放单位的在线监测端设备与碳排放数据中心之间的数据交换传输。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政区划代码 GB/T 4754 国民经济行业分类 GB 18030 信息技术 中文编码字符集 GB 32100 法人和其他组织统一社会信用代码编码规
4、则 GB/T 32150 工业企业温室气体排放核算和报告通则 GB/T 32151(所有部分)温室气体排放核算与报告要求 JJF 1051 计量器具命名与分类编码 3 术语和定义 GB/T 2260、GB/T 4754、GB 18030、GB 32100、GB/T 32150、GB/T 32151(所有部分)和JJF 1051界定的以及下列术语和定义适用于本文件。3.1 温室气体 greenhouse gas 大气层中自然存在的和由于人类活动产生的能够吸收和散发由地球表面、大气层和云层所产生的、波长在红外光谱内的辐射的气态成分。来源:GB/T 321502015,3.1 3.2 排放单位 or
5、ganization of greenhouse gas emission 具有温室气体排放行为的法人企业或视同法人的独立核算单位。来源:GB/T 321502015,3.2,有修改 3.3 排放源 emission source 向大气中排放温室气体排放的物理单元或过程。来源:GB/T 321502015,3.5,有修改 DB35/T 20002021 2 3.4 全球变暖潜势 global warming potential 将单位质量的某种温室气体在给定时间段内辐射强度影响与等量二氧化碳辐射强度影响相关联的系数。来源:GB/T 321502015,3.15,有修改 3.5 碳排放数据 c
6、arbon emission data 与二氧化碳当量计算相关的温室气体排放数据。3.6 碳排放数据中心 carbon emission data center 接收、存储、处理和分析在线监测端设备上传的数据,并将碳排放数据核算为二氧化碳当量的软件系统和硬件系统的总称。3.7 在线监测端设备 online monitoring terminal equipment 安装在排放单位,用于采集、存储、处理碳排放数据,并可通过通讯网络与碳排放数据中心进行数据传输的设备。3.8 碳排放数据公共平台 public platform of carbon emission data 由碳排放数据中心与排放单
7、位在线监测端设备组成,应用于碳排放数据的在线采集、实时监测和数据分析等公共服务。4 缩略语 下列缩略语适用于本文件。HTTPS:安全超文本传输协议(Hyper Text Transfer Protocol Over Secure Socket Layer)JSON:一种轻量级的数据交换格式(JavaScript Object Notation)TCP/IP:传输控制协议/网际协议(Transmission Control Protocol/Internet Protocol)URL:统一资源定位符(Uniform Resource Locator)5 平台架构 平台架构由碳排放数据中心、通讯网
8、络和排放单位的在线监测端设备组成。平台架构如图1所示。DB35/T 20002021 3 图1 碳排放数据公共平台架构 6 通讯协议 碳排放数据中心与在线监测端设备之间的传输层基于TCP/IP协议通讯,应用层基于HTTPS协议通讯,协议关系如图2所示。在应用层传输的报文采用JSON交换格式,字符/汉字采用GB 18030编码。图2 通讯协议层次图 DB35/T 20002021 4 7 通讯架构 7.1 通讯模式 碳排放数据公共平台通讯模式为“客户端请求/服务端应答”模式,通讯模式如图3所示。其中,在线监测端设备是发起通讯请求的客户端,碳排放数据中心是应答通讯请求的服务端。图3 通讯模式图 7
9、.2 通讯报文结构 通讯报文结构见表1。表1 通讯报文结构表 序号 发送方 属性 名称 说明 1 在线监测端设备 URL 请求地址 在线监测端设备发起不同请求的碳排放数据中心通讯地址,具体地址定义见表 2。2 Method 请求方法 在线监测端设备请求上传资源。3 Header 请求头 在线监测端设备注册前,内容为空;在线监测端设备注册后,内容为在线监测端设备的 appId 和 token。4 Request请求参数 当在线监测端设备请求获取资源时,内容为空;当在线监测端设备请求上传资源时,内容为需要上传的资源。5 碳排放 数据中心 Response请求响应 当在线监测端设备请求获取资源时,内
10、容为碳排放数据中心回复相应的资源;当在线监测端设备请求上传资源时,内容为碳排放数据中心返回接收的情况。注:appId和token定义按照附录A的表A.1的规定。DB35/T 20002021 5 7.3 请求地址 在线监测端设备根据不同的需求发送不同的请求报文,请求报文的请求地址见表2。表2 请求地址表 序号 请求地址 说明 1 https:/apis/token 用于在线监测端设备获取 token。2 https:/apis/version 用于在线监测端设备获取基础数据版本号。3 https:/apis/downloadBaseData 用于在线监测端设备下载基础数据。4 https:/a
11、pis/uploadBaseInfo 用于在线监测端设备上传排放单位基本信息。5 https:/apis/uploadMeterInfo 用于在线监测端设备上传排放单位计量器具信息。6 https:/apis/uploadCollectItemInfo 用于在线监测端设备上传排放单位监测数据项信息。7 https:/apis/uploadCollectData 用于在线监测端设备上传排放参数采集数据信息。8 https:/apis/uploadCumulativeData 用于在线监测端设备上传仪表表头累积数据信息。注:apis为碳排放数据中心服务器的域名或IP。7.4 返回码 碳排放数据中心
12、成功接收并解析请求报文后,返回应答报文,在应答报文中包含返回码。返回码定义见表3。表3 返回码表 序号 返回码 说明 1 C0000 成功。2 C0001 成功,请上传最新的排放单位信息。3 C0002 成功,请上传最新的计量器具信息。4 C0003 成功,请上传最新的监测数据项信息。5 C0004 成功,请上传相关仪表表头数据。6 C0005 成功,请补传相关监测数据项历史数据。7 C0101 成功,请注意系统通知。8 C1001 系统服务异常。9 C1002 数据库异常。10 C1003 非正常发起请求时间段。11 C2001 上传参数无法识别。12 C2002 上传参数的内容缺失。13
13、C2003 上传参数的格式错误。14 C2101 上传数据的时间错误。15 C2102 上传数据的内容错误。16 C2103 上传数据的数值大小异常。17 C3001 appKey 无效。DB35/T 20002021 6 表3 返回码表(续)序号 返回码 说明 18 C3002 token 无效。19 C9001 其他未知错误。注:appKey定义按照附录A的表A.1的规定。8 通讯接口 8.1 接口类型 通讯接口包括在线监测端设备注册、平台基础数据版本校验、排放单位信息及数据上传等3种类型。8.2 在线监测端设备注册接口 8.2.1 在线监测端设备向碳排放数据中心发起初始连接请求时,应提交
14、注册申请,流程包括报备申请、token 申请和平台基础数据下载等三个环节。具体流程如图 4 所示。流程开始排放单位申请在线监测端设备报备报备申请是否成功在线监测端设备发送token申请请求token申请是否成功在线监测端设备发送基础数据下载请求基础数据下载是否成功流程结束否是否否是是 图4 在线监测端设备注册流程 DB35/T 20002021 7 8.2.2 排放单位向碳排放数据中心提交在线监测端设备报备申请,碳排放数据中心审核通过后,将碳排放数据中心服务器的域名或 IP、在线监测端设备的 appId 和 appKey 等信息,通过第三方网络发送至排放单位。8.2.3 token 申请和平台
15、基础数据下载等通讯过程的相关参数信息和代码示例索引见表 4。表4 在线监测端设备注册流程信息索引表 序号 环节 参数信息 代码示例 1 token申请请求 按照附录A的表A.2的规定 见附录B的表B.1 2 基础数据下载请求 按照附录A的表A.3的规定 见附录B的表B.2 8.3 平台基础数据版本校验接口 8.3.1 在线监测端设备向碳排放数据中心发送平台基础数据版本校验请求,同步碳排放数据中心的最新版本基础数据。具体流程如图 5 所示。流程开始在线监测端设备发送基础数据版本校验请求token是否失效在线监测端设备发送token申请请求是否否是否在线监测端设备发送基础数据下载请求基础数据下载是
16、否成功是否是流程结束token申请是否成功基础数据版本是否更新 图5 平台基础数据版本校验流程 DB35/T 20002021 8 8.3.2 各环节通讯过程的相关参数信息和代码示例索引见表 5。表5 平台基础数据版本校验流程信息索引表 序号 环节 参数信息 代码示例 1 基础数据版本校验请求 按照附录 A 的表 A.5 的规定见附录 B 的表 B.3 2 token 申请请求 按照附录 A 的表 A.2 的规定见附录 B 的表 B.1 3 基础数据下载请求 按照附录 A 的表 A.3 的规定见附录 B 的表 B.2 8.4 排放单位信息及数据上传接口 8.4.1 排放单位信息包括基本信息、计
17、量器具信息和监测数据项信息,排放单位数据包括排放参数采集数据和仪表表头累积数据。具体流程如图 6 所示。流程开始在线监测端设备发送排放单位信息/数据上传情况token是否失效是在线监测端设备发送token申请请求否排放单位信息/数据是否上传成功否是流程结束token申请是否成功是否 图6 排放单位信息/数据上传流程 8.4.2 在线监测端设备在碳排放中心完成注册或更新排放单位信息后,应向碳排放数据中心上传最新的排放单位信息。8.4.3 各环节通讯过程的相关参数信息和代码示例索引见表 6。表6 排放单位信息/数据上传流程信息索引表 序号 环节 参数信息 代码示例 1 排放单位基本信息上传 按照附
18、录 A 的表 A.6 的规定见附录 B 的表 B.4 2 排放单位计量器具信息上传 按照附录 A 的表 A.7 的规定见附录 B 的表 B.5 3 排放单位监测数据项信息上传 按照附录 A 的表 A.8 的规定见附录 B 的表 B.6 DB35/T 20002021 9 表6 排放单位信息/数据上传流程信息索引表(续)序号 环节 参数信息 代码示例 4 排放参数采集数据上传 按照附录 A 的表 A.9 的规定 见附录 B 的表 B.7 5 仪表表头累积数据上传 按照附录 A 的表 A.10 的规定 见附录 B 的表 B.8 9 监测数据项编码 在线监测端设备上传排放单位数据时,应上传每个监测数
19、据项的编码。监测数据项编码由15位阿拉伯数字组成,包括排放行业、排放活动、排放源、排放参数和监测点序号等代码信息,编码结构如图7所示。3位监测序号代码2位二级排放参数代码2位一级排放参数代码2位排放源分项代码2位排放源分类代码2位排放活动代码2位排放行业代码X XX XX XX XX X XX XX X 图7 编码结构 各段编码要求如下:a)排放行业、排放活动、排放源与排放参数的层级关系,根据各行业核算指南的核算方法定义,编码信息按照附录 C 的规定;b)监测点序号由 3 位阿拉伯数字组成,在 001999 范围内按序编码。示例:某排放单位的某监测数据项编码是 100207200202003,
20、该编码意为:化工生产企业工业生产过程排放原料消耗(碳产品)甲醇碳产品碳产品含碳量第 3 个监测点。DB35/T 20002021 10 A A 附录A (规范性)参数信息 表A.1A.10分别为设备、token申请请求、平台基础数据下载请求、平台基础数据下载请求的字典、基础数据版本校验请求、排放单位基本信息上传请求、排放单位计量器具信息上传请求、排放单位监测数据项信息上传请求、排放参数采集数据上传请求、仪表表头累积数据上传请求等参数信息,表A.1A.10的通讯接口中的参数类型均为字符型。表A.1 设备参数信息 序号 参数名称 数据长度 byte 描述 1 appId 32 碳排放数据中心分配给
21、在线监测端设备的设备唯一标识码。2 appKey 32 碳排放数据中心分配给在线监测端设备的密钥。3 token 32 碳排放数据中心分配给在线监测端设备的验证码。注1:碳排放数据中心按照管理要求不定期更新密钥。注2:token具有使用有效期,其失效后在线监测端设备应向碳排放数据中心重新提出申请。表A.2 token 申请请求的参数信息 序号 发送方 参数名称 数据长度 byte 描述 1 在线监测端设备 appId 32 见表 A.1。2 appKey 32 见表 A.1。3 碳排放数据中心 token 32 见表 A.1。4 expiredDate 19 token 过期时间,格式如“yy
22、yy-MM-dd HH:mm:ss”。5 responseCode 5 请求状态返回码,定义见表 3。6 responseMsg 255 返回状态信息。DB35/T 20002021 11 表A.3 平台基础数据下载请求的参数信息 序号 发送方 参数名称 数据长度 byte 描述 1 在线监测端设备 appId 32 见表 A.1。2 token 32 见表 A.1。3 碳排放数据中心 字典参数 见表 A.4。4 uploadTime 8 每日上传数据时间点,格式如“HH:mm:ss”。5 responseCode 5 请求状态返回码,定义见表 3。6 responseMsg 255 返回状态
23、信息。表A.4 平台基础数据下载请求的字典参数信息 项目 名称 子项目 子项目名称 数据长度 byte 备注 iRegion 行政区划 code 区划编码 6 按照 GB/T 2260 的规定编写。name 区划名称 128 pCode 区划父编码 6 type 区划类型 1 字符1省级,字符2设区市级,字符3县(区、市)级。iEnterpriseType 排放单位类型 code 单位类型编码 3 参照关于划分企业登记注册类型的规定调整的通知附件中的“企业登记注册类型与代码”编写。name 单位类型名称 128 iEconomicIndustry 经济行业 code 行业编码 5 按照 GB/
24、T 4754 的规定编写。name 行业名称 255 pCode 行业父编码 4 DB35/T 20002021 12 表 A.4 平台基础数据下载请求的字典参数信息(续)项目 名称 子项目 子项目名称 数据长度 byte 备注 iEmissionIndustry 排放行业 code 行业编码 2 按照附录 C 的表 C.1 的规定编写。name 行业名称 128 iEmissionActivity 排放活动 code 排放活动编码 2 按照附录 C 的表 C.2 的规定编写。name 排放活动名称 128 iEmissionSource 排放源 code 排放源编码 2 按照附录 C 的表
25、C.2 和表 C.3 的规定编写。name 排放源名称 128 type 排放源等级 1 字符1分类,字符2分项。pCode 排放源父编码 2 排放源等级为分类级时,此项为空;排放源等级为分项级时,此项为分类编码。emiActCode 排放活动编码 2 iEmissionParameter 排放参数 code 排放参数编码 2 按照附录 C 的表 C.2 的规定编写。name 排放参数名称 128 type 排放参数等级 1 字符1一级,字符2二级 pCode 排放参数父编码 2 排放参数等级为一级时,此项为空;排放参数等级为二级时,此项为一级编码。emiSouTypeCode 排放源分类编码
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB35T 2000-2021 碳排放数据公共平台数据传输协议福建省 DB35 2000 2021 排放 数据 公共 平台 数据传输 协议 福建省
限制150内