DB35/T 2000-2021 碳排放数据公共平台数据传输协议
DB35/T 2000-2021 Carbon Emission Data Public Platform Data Transmission Protocol
基本信息
发布历史
-
2021年08月
研制信息
- 起草单位:
- 福建省计量科学研究院、厦门奥普拓自控科技有限公司。
- 起草人:
- 方仁桂、吴孟辉、褚丹雷、姚进辉、陆青、王智苑、陈为晶、林荣捷。
- 出版信息:
- 页数:56页 | 字数:- | 开本: -
内容描述
ICS35.020
CCSL70
35
福建省地方标准
DB35/T2000—2021
碳排放数据公共平台数据传输协议
Protocolfordatacommunicationofcarbonemissiondatapublicplatform
2021-08-17发布2021-11-17实施
福建省市场监督管理局发布
DB35/T2000—2021
目次
前言.................................................................................II
1范围...............................................................................1
2规范性引用文件.....................................................................1
3术语和定义.........................................................................1
4缩略语.............................................................................2
5平台架构...........................................................................2
6通讯协议...........................................................................3
7通讯架构...........................................................................4
8通讯接口...........................................................................6
9监测数据项编码.....................................................................9
附录A(规范性)参数信息............................................................10
附录B(资料性)数据传输代码示例....................................................20
附录C(规范性)编码信息............................................................33
参考文献.............................................................................53
I
DB35/T2000—2021
前言
本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定
起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由福建省计量科学研究院提出。
本文件由福建省信息化标准化技术委员会(SAFJ/TC11)归口。
本文件起草单位:福建省计量科学研究院、厦门奥普拓自控科技有限公司。
本文件主要起草人:方仁桂、吴孟辉、褚丹雷、姚进辉、陆青、王智苑、陈为晶、林荣捷。
II
DB35/T2000—2021
碳排放数据公共平台数据传输协议
1范围
本文件规定了碳排放数据公共平台数据传输的平台架构、通讯协议、通讯架构、通讯接口和监测数
据项编码。
本文件适用于排放单位的在线监测端设备与碳排放数据中心之间的数据交换传输。
2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文
件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用
于本文件。
GB/T2260中华人民共和国行政区划代码
GB/T4754国民经济行业分类
GB18030信息技术中文编码字符集
GB32100法人和其他组织统一社会信用代码编码规则
GB/T32150工业企业温室气体排放核算和报告通则
GB/T32151(所有部分)温室气体排放核算与报告要求
JJF1051计量器具命名与分类编码
3术语和定义
GB/T2260、GB/T4754、GB18030、GB32100、GB/T32150、GB/T32151(所有部分)和JJF1051
界定的以及下列术语和定义适用于本文件。
3.1
温室气体greenhousegas
大气层中自然存在的和由于人类活动产生的能够吸收和散发由地球表面、大气层和云层所产生的、
波长在红外光谱内的辐射的气态成分。
[来源:GB/T32150—2015,3.1]
3.2
排放单位organizationofgreenhousegasemission
具有温室气体排放行为的法人企业或视同法人的独立核算单位。
[来源:GB/T32150—2015,3.2,有修改]
3.3
排放源emissionsource
向大气中排放温室气体排放的物理单元或过程。
[来源:GB/T32150—2015,3.5,有修改]
1
DB35/T2000—2021
3.4
全球变暖潜势globalwarmingpotential
将单位质量的某种温室气体在给定时间段内辐射强度影响与等量二氧化碳辐射强度影响相关联的
系数。
[来源:GB/T32150—2015,3.15,有修改]
3.5
碳排放数据carbonemissiondata
与二氧化碳当量计算相关的温室气体排放数据。
3.6
碳排放数据中心carbonemissiondatacenter
接收、存储、处理和分析在线监测端设备上传的数据,并将碳排放数据核算为二氧化碳当量的软件
系统和硬件系统的总称。
3.7
在线监测端设备onlinemonitoringterminalequipment
安装在排放单位,用于采集、存储、处理碳排放数据,并可通过通讯网络与碳排放数据中心进行数
据传输的设备。
3.8
碳排放数据公共平台publicplatformofcarbonemissiondata
由碳排放数据中心与排放单位在线监测端设备组成,应用于碳排放数据的在线采集、实时监测和数
据分析等公共服务。
4缩略语
下列缩略语适用于本文件。
HTTPS:安全超文本传输协议(HyperTextTransferProtocolOverSecureSocketLayer)
JSON:一种轻量级的数据交换格式(JavaScriptObjectNotation)
TCP/IP:传输控制协议/网际协议(TransmissionControlProtocol/InternetProtocol)
URL:统一资源定位符(UniformResourceLocator)
5平台架构
平台架构由碳排放数据中心、通讯网络和排放单位的在线监测端设备组成。平台架构如图1所示。
2
DB35/T2000—2021
图1碳排放数据公共平台架构
6通讯协议
碳排放数据中心与在线监测端设备之间的传输层基于TCP/IP协议通讯,应用层基于HTTPS协议通讯,
协议关系如图2所示。在应用层传输的报文采用JSON交换格式,字符/汉字采用GB18030编码。
图2通讯协议层次图
3
DB35/T2000—2021
7通讯架构
7.1通讯模式
碳排放数据公共平台通讯模式为“客户端请求/服务端应答”模式,通讯模式如图3所示。其中,在
线监测端设备是发起通讯请求的客户端,碳排放数据中心是应答通讯请求的服务端。
图3通讯模式图
7.2通讯报文结构
通讯报文结构见表1。
表1通讯报文结构表
序号发送方属性名称说明
在线监测端设备发起不同请求的碳排放数据中心通讯地址,具体地址定
1URL请求地址
义见表2。
2Method请求方法在线监测端设备请求上传资源。
在线监测
在线监测端设备注册前,内容为空;
3端设备Header请求头
在线监测端设备注册后,内容为在线监测端设备的appId和token。
当在线监测端设备请求获取资源时,内容为空;
4Request请求参数
当在线监测端设备请求上传资源时,内容为需要上传的资源。
当在线监测端设备请求获取资源时,内容为碳排放数据中心回复相应的
碳排放
5Response请求响应资源;当在线监测端设备请求上传资源时,内容为碳排放数据中心返回
数据中心
接收的情况。
注:appId和token定义按照附录A的表A.1的规定。
4
DB35/T2000—2021
7.3请求地址
在线监测端设备根据不同的需求发送不同的请求报文,请求报文的请求地址见表2。
表2请求地址表
序号请求地址说明
1https://apis/token用于在线监测端设备获取token。
2https://apis/version用于在线监测端设备获取基础数据版本号。
3https://apis/downloadBaseData用于在线监测端设备下载基础数据。
4https://apis/uploadBaseInfo用于在线监测端设备上传排放单位基本信息。
5https://apis/uploadMeterInfo用于在线监测端设备上传排放单位计量器具信息。
6https://apis/uploadCollectItemInfo用于在线监测端设备上传排放单位监测数据项信息。
7https://apis/uploadCollectData用于在线监测端设备上传排放参数采集数据信息。
8https://apis/uploadCumulativeData用于在线监测端设备上传仪表表头累积数据信息。
注:apis为碳排放数据中心服务器的域名或IP。
7.4返回码
碳排放数据中心成功接收并解析请求报文后,返回应答报文,在应答报文中包含返回码。返回码定
义见表3。
表3返回码表
序号返回码说明
1C0000成功。
2C0001成功,请上传最新的排放单位信息。
3C0002成功,请上传最新的计量器具信息。
4C0003成功,请上传最新的监测数据项信息。
5C0004成功,请上传相关仪表表头数据。
6C0005成功,请补传相关监测数据项历史数据。
7C0101成功,请注意系统通知。
8C1001系统服务异常。
9C1002数据库异常。
10C1003非正常发起请求时间段。
11C2001上传参数无法识别。
12C2002上传参数的内容缺失。
13C2003上传参数的格式错误。
14C2101上传数据的时间错误。
15C2102上传数据的内容错误。
16C2103上传数据的数值大小异常。
17C3001appKey无效。
5
DB35/T2000—2021
表3返回码表(续)
序号返回码说明
18C3002token无效。
19C9001其他未知错误。
注:appKey定义按照附录A的表A.1的规定。
8通讯接口
8.1接口类型
通讯接口包括在线监测端设备注册、平台基础数据版本校验、排放单位信息及数据上传等3种类型。
8.2在线监测端设备注册接口
8.2.1在线监测端设备向碳排放数据中心发起初始连接请求时,应提交注册申请,流程包括报备申请、
token申请和平台基础数据下载等三个环节。具体流程如图4所示。
流程开始
排放单位申请
在线监测端设备报备
报备申请否
是否成功
是
在线监测端设备
发送token申请请求
token申请否
是否成功
是
在线监测端设备
发送基础数据
下载请求
基础数据否
下载是否成功
是
流程结束
图4在线监测端设备注册流程
6
DB35/T2000—2021
8.2.2排放单位向碳排放数据中心提交在线监测端设备报备申请,碳排放数据中心审核通过后,将碳
排放数据中心服务器的域名或IP、在线监测端设备的appId和appKey等信息,通过第三方网络发送至
排放单位。
8.2.3token申请和平台基础数据下载等通讯过程的相关参数信息和代码示例索引见表4。
表4在线监测端设备注册流程信息索引表
序号环节参数信息代码示例
1token申请请求按照附录A的表A.2的规定见附录B的表B.1
2基础数据下载请求按照附录A的表A.3的规定见附录B的表B.2
8.3平台基础数据版本校验接口
8.3.1在线监测端设备向碳排放数据中心发送平台基础数据版本校验请求,同步碳排放数据中心的最
新版本基础数据。具体流程如图5所示。
流程开始
在线监测端设备
发送基础数据版本校
验请求
是
token
是否失效
在线监测端设备
否发送token申请
请求
token申请否
是否成功
是
基础数据版本是
是否更新
在线监测端设备
否发送基础数据
下载请求
基础数据否
下载是否成功
是
流程结束
图5平台基础数据版本校验流程
7
DB35/T2000—2021
8.3.2各环节通讯过程的相关参数信息和代码示例索引见表5。
表5平台基础数据版本校验流程信息索引表
序号环节参数信息代码示例
1基础数据版本校验请求按照附录A的表A.5的规定见附录B的表B.3
2token申请请求按照附录A的表A.2的规定见附录B的表B.1
3基础数据下载请求按照附录A的表A.3的规定见附录B的表B.2
8.4排放单位信息及数据上传接口
8.4.1排放单位信息包括基本信息、计量器具信息和监测数据项信息,排放单位数据包括排放参数采
集数据和仪表表头累积数据。具体流程如图6所示。
流程开始
在线监测端设备
发送排放单位
信息/数据上传情况
是在线监测端设备
token
发送token
是否失效
申请请求
否
否
排放单位信息/token申请否
数据是否上传成功是否成功
是是
流程结束
图6排放单位信息/数据上传流程
8.4.2在线监测端设备在碳排放中心完成注册或更新排放单位信息后,应向碳排放数据中心上传最新
的排放单位信息。
8.4.3各环节通讯过程的相关参数信息和代码示例索引见表6。
表6排放单位信息/数据上传流程信息索引表
序号环节参数信息代码示例
1排放单位基本信息上传按照附录A的表A.6的规定见附录B的表B.4
2排放单位计量器具信息上传按照附录A的表A.7的规定见附录B的表B.5
3排放单位监测数据项信息上传按照附录A的表A.8的规定见附录B的表B.6
8
DB35/T2000—2021
表6排放单位信息/数据上传流程信息索引表(续)
序号环节参数信息代码示例
4排放参数采集数据上传按照附录A的表A.9的规定见附录B的表B.7
5仪表表头累积数据上传按照附录A的表A.10的规定见附录B的表B.8
9监测数据项编码
在线监测端设备上传排放单位数据时,应上传每个监测数据项的编码。监测数据项编码由15位阿拉
伯数字组成,包括排放行业、排放活动、排放源、排放参数和监测点序号等代码信息,编码结构如图7
所示。
XXXXXXXXXXXXXXX
3位监测序号代码
2位二级排放参数代码
2位一级排放参数代码
2位排放源分项代码
2位排放源分类代码
2位排放活动代码
2位排放行业代码
图7编码结构
各段编码要求如下:
a)排放行业、排放活动、排放源与排放参数的层级关系,根据各行业核算指南的核算方法定义,
编码信息按照附录C的规定;
b)监测点序号由3位阿拉伯数字组成,在001~999范围内按序编码。
示例:某排放单位的某监测数据项编码是100207200202003,该编码意为:化工生产企业—工业生产过程排放—原
料消耗—(碳产品)甲醇—碳产品—碳产品含碳量—第3个监测点。
9
DB35/T2000—2021
A
A
附录A
(规范性)
参数信息
表A.1~A.10分别为设备、token申请请求、平台基础数据下载请求、平台基础数据下载请求的字典、基础数据版本校验请求、排放
单位基本信息上传请求、排放单位计量器具信息上传请求、排放单位监测数据项信息上传请求、排放参数采集数据上传请求、仪表表头
累积数据上传请求等参数信息,表A.1~A.10的通讯接口中的参数类型均为字符型。
表A.1设备参数信息
数据长度
序号参数名称描述
byte
1appId32碳排放数据中心分配给在线监测端设备的设备唯一标识码。
2appKey32碳排放数据中心分配给在线监测端设备的密钥。
3token32碳排放数据中心分配给在线监测端设备的验证码。
注1:碳排放数据中心按照管理要求不定期更新密钥。
注2:token具有使用有效期,其失效后在线监测端设备应向碳排放数据中心重新提出申请。
表A.2token申请请求的参数信息
数据长度
序号发送方参数名称描述
byte
1appId32见表A.1。
在线监测端设备
2appKey32见表A.1。
3token32见表A.1。
4expiredDate19token过期时间,格式如“yyyy-MM-ddHH:mm:ss”。
碳排放数据中心
5responseCode5请求状态返回码,定义见表3。
6responseMsg255返回状态信息。
10
DB35/T2000—2021
表A.3平台基础数据下载请求的参数信息
序号发送方参数名称数据长度byte描述
1appId32见表A.1。
在线监测端设备
2token32见表A.1。
3字典参数—见表A.4。
4uploadTime8每日上传数据时间点,格式如“HH:mm:ss”。
碳排放数据中心
5responseCode5请求状态返回码,定义见表3。
6responseMsg255返回状态信息。
表A.4平台基础数据下载请求的字典参数信息
数据长度
项目名称子项目子项目名称备注
byte
code区划编码6
name区划名称128按照GB/T2260的规定编写。
iRegion行政区划pCode区划父编码6
字符‘1’——省级,字符‘2’——设区市
type区划类型1
级,字符‘3’—
定制服务
推荐标准
- DB3305/T 314-2024 转型金融贷款管理规范 2024-08-15
- DB3305/T 320-2024 养老机构一床一码工作规范 2024-08-15
- DB3303/T 080-2024 “共享社·幸福里”建设规范 2024-08-06
- DB3305/T 317-2024 农村残疾人就业创业帮扶基地建设与服务规范 2024-08-15
- DB3303/T 078-2024 规模以上工业企业健康评价指标体系 2024-07-25
- DB3305/T 316-2024 交通工程混凝土拌和站建设规范 2024-08-15
- DB3303/T 081-2024 中华蜜蜂人工育王技术规程 2024-08-15
- DB3305/T 319-2024 公共建筑运行能耗与碳排放强度分级规范 2024-08-15
- DB3305/T 315-2024 交通工程预制场建设规范 2024-08-15
- DB3303/T 079-2024 网络餐饮"阳光厨房"建设运行规范 2024-07-25