DB52-T 1669.2-2022 气瓶质量安全追溯系统 第2部分：数据接口

ICS29.020CCSK09DB52/T1669.2—2022气瓶质量安全追溯系统第2部分：数据接口Part2：Datainterface2022-05-31发布2022-09-01实施贵州省市场监督管理局发布IDB52/T1669.2—2022前言 12规范性引用文件 13术语和定义 14缩略语 1 26接口消息格式 27接口基本功能和参数 3参考文献 DB52/T1669.2—2022DB52/T1669.2—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB52/T1669《气瓶质量安全追溯系统》的第2部分。DB52/T1669已经发布了以下部分：——第1部分：通用要求；——第2部分：数据接口；——第3部分：气瓶信息化标签；——第4部分：充装读写控制设备。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由贵州省市场监督管理局提出并归口。本文件起草单位：贵州省特种设备检验检测院、贵州省市场监督管理局、贵州由你想信息科技有限公司、贵州省市场监管局大数据中心、六盘水市特种设备检验所、云南中石化燃气有限公司、贵州四维燃气有限公司、遵义市特种设备检验所、贵州省标准化院。本文件主要起草人：刘志鹏、张书辉、符文迪、马祥、吴恒、王勃、刘安路、梁志、黄康、杨鹏、关志华、朱云乐、刘朝琴、陈江博、王泽西、王玲、潘胜荣、李炜、罗凌、徐超、吕根源、陈星源、聂印、文富聪、陈贵堂、游远飞、潘昌亮、贾福波、韩霜、杭洪。DB52/T1669.2—2022气瓶与人民群众日常生活密切相关，直接关系到人民群众的生命安全与生活质量。随着贵州经济社会高质量发展，气瓶数量急速增长，气瓶泄漏或爆炸事件时有发生，对人民群众生命财产安全造成了较大的潜在威胁，传统的气瓶安全监管方式已不适应气瓶安全监管工作的需要。为加强气瓶质量安全监管，构建以信息化为手段的气瓶安全监管方式，实现气瓶质量安全的全生命周期信息化管理、质量安全控制和追溯，保障气瓶安全使用。DB52/T1669旨在确立气瓶质量安全追溯系统的相关要求，由四个部分组成。——第1部分：通用要求。目的在于确定气瓶质量安全追溯系统的系统架构、监管平台、企业平台、数据体系、安全体系及管理体系的要求。——第2部分：数据接口。目的在于确定气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数的要求。——第3部分：气瓶信息化标签。目的在于确定气瓶质量安全追溯系统气瓶信息化标签的功能要求、防伪特性、数据要求、安装要求和使用要求。——第4部分：充装读写控制设备。目的在于确定气瓶质量安全追溯系统气瓶充装读写控制设备DB52/T1669.2—20221气瓶质量安全追溯系统第2部分：数据接口本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T13000信息技术通用多八位编码字符集（UCS）RFC2616超文本传输协议1.1（HypertextTransferProtocol—HTTP/1.1）RFC4627JSON应用与媒体类型[Theapplication/jsonMediaTypeforJavaScriptObjectNotation(JSON)]3术语和定义下列术语和定义适用于本文件。3.1气瓶信息化标签实现气瓶生命周期中充装验证和追溯的信息化媒介。3.2编码字符集一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。[来源：GB/T1988-1998，4.6]4缩略语下列缩略语适用于本文件。GTM：格林威治时间（GreenwichMeanTime）HTML：超文本置标语言（HyperTextMarkupLanguage）HTTP：超文本传输协议（HyperTextTransferProtocol）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer或HypertextTransferProtocolSecure）ID：标识符（Identifier）JSON：轻量级的数据交换格式（JavaScriptObjectNotation）MIME：多用途互联网邮件扩展（MultipurposeInternetMailExtensions）2DB52/T1669.2—20225总体要求5.1通信协议应采用符合RFC2616的HTTP或HTTPS。5.2接口描述宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。5.3编码字符集应符合GB/T13000的要求。5.4数据类型气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：——字符串型（String）；——数字型（Number）；——时间型（DateTime）；——对象型（Object）；——数组型（Array——布尔型（Boolean）；——空（NULL）。6接口消息格式6.1请求消息格式6.1.1消息格式请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。6.1.2请求头不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。表1请求头DB52/T1669.2—20223HTTP请求发送时，会把保存在该请求域名下的所6.1.3请求参数请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。6.2响应消息格式6.2.1消息格式响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。6.2.2响应头不同接口具有同一响应头，响应头的名称及其含义描述应符合表2的规定。表2响应头6.2.3响应参数响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。----7接口基本功能和参数7.1接口流程企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下：a)企业平台发出请求，上报数据或请求数据；b)监管平台对该次请求进行处理；DB52/T1669.2—20224c)处理后由监管平台向企业平台返回处理结果。图1接口流程7.2初始化连通接口7.2.1功能用于企业平台和监管平台间建立初始化连通。7.2.2请求参数初始化连通请求参数应符合表3的规定。表3初始化连通请求参数7.2.3响应消息参数初始化连通响应消息参数应符合表4的规定。表4初始化连通响应消息参数DB52/T1669.2—202257.3请求类接口7.3.1请求类接口列表请求类接口列表应符合表5的规定。表5请求类接口列表7.3.2请求类接口基本功能和参数气瓶基本信息.1功能用于企业平台查询监管平台内气瓶基本信息。.2请求参数气瓶基本信息请求参数应符合表6的规定。表6气瓶基本信息请求参数.3响应消息参数气瓶基本信息响应信息参数应符合表7的规定。表7气瓶基本信息响应消息参数DB52/T1669.2—20226表7（续））：气瓶充装信息.1功能用于企业平台查询监管平台内气瓶最新一条充装信息。DB52/T1669.2—2022.2请求参数气瓶充装信息请求参数应符合表8的规定。表8气瓶充装信息请求参数.3响应消息参数气瓶充装信息响应消息参数应符合表9的规定。表9气瓶充装信息响应消息参数气瓶定期检验信息.1功能用于企业平台查询监管平台内气瓶最新检验信息。.2请求参数气瓶定期检验信息请求参数应符合表10的规定。表10气瓶定期检验信息请求参数.3响应消息参数气瓶定期检验信息响应消息参数应符合表11的规定，气瓶定期检验明细应符合表12的规定。DB52/T1669.2—20228表11气瓶定期检验信息响应消息参数表12气瓶定期检验明细气瓶信息化标签信息.1功能用于企业平台查询监管平台内气瓶信息化标签信息。.2请求参数气瓶信息化标签信息请求参数应符合表13的规定。表13气瓶信息化标签信息请求参数DB52/T1669.2—2022.3响应消息参数气瓶信息化标签信息响应消息参数应符合表14的规定。表14气瓶信息化标签信息响应消息参数7.4上报类接口7.4.1上报类接口列表应符合表15的规定。表15上报类接口列表7.4.2上报类接口基本功能和参数气瓶流转信息.1功能用于企业平台向监管平台上报气瓶信流转过程的信息，包括气瓶运输信息、气瓶仓储信息、气瓶配送信息。.2