ICS 29.020 CCS K 009 52 2 贵 州 省 地 方 标 准 DB522/T 1669.2—20222 气瓶 瓶质量 量安全 全追溯 溯系统 统 第2部 部分：数据接口 Quality and saf fety tracceability system m for gass cylinder— Part 2：Data interfac ce 2022 - 09 0 - 01 实施 实 2022 - 05 - 31 发布 发 贵州省市场 贵 场监督管理 理局 发 布 DB52/T 1669.2—2022 目 次 前言 ................................................................................. II 引言 ................................................................................ III 1 范围 ............................................................................... 1 2 规范性引用文件 ..................................................................... 1 3 术语和定义 ......................................................................... 1 4 缩略语 ............................................................................. 1 5 总体要求 ........................................................................... 2 6 接口消息格式 ....................................................................... 2 7 接口基本功能和参数 ................................................................. 3 参考文献 ............................................................................. 11 I DB52/T 1669.2—2022 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件是DB52/T 1669《气瓶质量安全追溯系统》的第2部分。DB52/T 1669已经发布了以下部分： ——第 1 部分：通用要求； ——第 2 部分：数据接口； ——第 3 部分：气瓶信息化标签； ——第 4 部分：充装读写控制设备。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由贵州省市场监督管理局提出并归口。 本文件起草单位：贵州省特种设备检验检测院、贵州省市场监督管理局、贵州由你想信息科技有限 公司、贵州省市场监管局大数据中心、六盘水市特种设备检验所、云南中石化燃气有限公司、贵州四维 燃气有限公司、遵义市特种设备检验所、贵州省标准化院。 本文件主要起草人：刘志鹏、张书辉、符文迪、马祥、吴恒、王勃、刘安路、梁志、黄康、杨鹏、 关志华、朱云乐、刘朝琴、陈江博、王泽西、王玲、潘胜荣、李炜、罗凌、徐超、吕根源、陈星源、聂 印、文富聪、陈贵堂、游远飞、潘昌亮、贾福波、韩霜、杭洪。 II DB52/T 1669.2—2022 引 言 气瓶与人民群众日常生活密切相关，直接关系到人民群众的生命安全与生活质量。随着贵州经济社 会高质量发展，气瓶数量急速增长，气瓶泄漏或爆炸事件时有发生，对人民群众生命财产安全造成了较 大的潜在威胁，传统的气瓶安全监管方式已不适应气瓶安全监管工作的需要。为加强气瓶质量安全监管， 构建以信息化为手段的气瓶安全监管方式，实现气瓶质量安全的全生命周期信息化管理、质量安全控制 和追溯，保障气瓶安全使用。DB52/T 1669旨在确立气瓶质量安全追溯系统的相关要求，由四个部分组 成。 ——第 1 部分：通用要求。目的在于确定气瓶质量安全追溯系统的系统架构、监管平台、企业平 台、数据体系、安全体系及管理体系的要求。 ——第 2 部分：数据接口。目的在于确定气瓶质量安全追溯系统数据接口的总体要求、接口消息 格式、接口基本功能和参数的要求。 ——第 3 部分：气瓶信息化标签。目的在于确定气瓶质量安全追溯系统气瓶信息化标签的功能要 求、防伪特性、数据要求、安装要求和使用要求。 ——第 4 部分：充装读写控制设备。目的在于确定气瓶质量安全追溯系统气瓶充装读写控制设备 的要求。 III DB52/T 1669.2—2022 气瓶质量安全追溯系统 第 2 部分：数据接口 1 范围 本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。 本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 13000 信息技术 通用多八位编码字符集（UCS） RFC 2616 超文本传输协议1.1（Hypertext Transfer Protocol—HTTP/1.1） RFC 4627 JSON应用与媒体类型 [The application/json Media Type for JavaScript Object Notation(JSON)] 3 术语和定义 下列术语和定义适用于本文件。 3.1 气瓶信息化标签 实现气瓶生命周期中充装验证和追溯的信息化媒介。 3.2 编码字符集 一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。 [来源：GB/T 1988-1998，4.6] 4 缩略语 下列缩略语适用于本文件。 GTM：格林威治时间（Greenwich Mean Time） HTML：超文本置标语言（Hyper Text Markup Language） HTTP：超文本传输协议（Hyper Text Transfer Protocol） HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over Secure Socket Layer 或 Hypertext Transfer Protocol Secure） ID：标识符（Identifier） JSON：轻量级的数据交换格式（JavaScript Object Notation） MIME：多用途互联网邮件扩展（Multipurpose Internet Mail Extensions） 1 DB52/T 1669.2—2022 5 总体要求 5.1 通信协议 应采用符合RFC 2616的HTTP或HTTPS。 5.2 接口描述 宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。 5.3 编码字符集 应符合GB/T 13000的要求。 5.4 数据类型 气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括： —— 字符串型（String）； —— 数字型（Number）； —— 时间型（DateTime）； —— 对象型（Object）； —— 数组型（Array）； —— 布尔型（Boolean）； —— 空（NULL）。 注： 对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。 6 接口消息格式 6.1 请求消息格式 6.1.1 消息格式 请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。 6.1.2 请求头 不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。 表1 请求头 名称 描述 必选/可选 Host 指定请求的服务器的域名和端口号 必选 Connection 表示是否需要持久连接 必选 Accept 表示接受所接收的内容类型 必选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 2 DB52/T 1669.2—2022 表1 名称 （续） 描述 必选/可选 HTTP请求发送时，会把保存在该请求域名下的所有cookie Cookie 可选 值一起发送给网站服务器 User-Agent 内容包含发出请求的用户信息 可选 Token 访问连接的密钥信息 可选 6.1.3 请求参数 请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。 示例： 参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明 - - - - 6.2 响应消息格式 6.2.1 消息格式 响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。 6.2.2 响应头 不同接口具有同一响应头，响应头的名称及其含义描述应符合表2的规定。 表2 响应头 名称 描述 必选/可选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Length 请求的内容长度 必选 Date 服务器消息发出的时间 可选 Server 服务器软件名称 可选 6.2.3 响应参数 响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。 示例： 参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明 - - - - 7 7.1 接口基本功能和参数 接口流程 企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下： a) 企业平台发出请求，上报数据或请求数据； b) 监管平台对该次请求