1、 ICS 29.CCS K 0贵2022-020 09 州Quality-05-31 发州气瓶第 and saf发布 贵省瓶质量第 2 部fety tracPart 贵州省市场地 量安全部分：ceabilit2：Data 场监督管理方全追溯数据y systeminterfac理局 发方DB52溯系统接口 m for gasce 发 布 52标2/T 1669统 s cylind2022-02 准.22022er 09-01 实准 2 实施DB52/T 1669.22022 I 目次 前言.II 引言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 总体要求
2、.2 6 接口消息格式.2 7 接口基本功能和参数.3 参考文献.11 DB52/T 1669.22022 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件是DB52/T 1669气瓶质量安全追溯系统的第2部分。DB52/T 1669已经发布了以下部分：第 1 部分：通用要求；第 2 部分：数据接口；第 3 部分：气瓶信息化标签；第 4 部分：充装读写控制设备。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由贵州省市场监督管理局提出并归口。本文件起草单位：贵州省特种设备检验检测院、贵州省市场监
3、督管理局、贵州由你想信息科技有限公司、贵州省市场监管局大数据中心、六盘水市特种设备检验所、云南中石化燃气有限公司、贵州四维燃气有限公司、遵义市特种设备检验所、贵州省标准化院。本文件主要起草人：刘志鹏、张书辉、符文迪、马祥、吴恒、王勃、刘安路、梁志、黄康、杨鹏、关志华、朱云乐、刘朝琴、陈江博、王泽西、王玲、潘胜荣、李炜、罗凌、徐超、吕根源、陈星源、聂印、文富聪、陈贵堂、游远飞、潘昌亮、贾福波、韩霜、杭洪。DB52/T 1669.22022 III 引言 气瓶与人民群众日常生活密切相关，直接关系到人民群众的生命安全与生活质量。随着贵州经济社会高质量发展，气瓶数量急速增长，气瓶泄漏或爆炸事件时有发生
4、，对人民群众生命财产安全造成了较大的潜在威胁，传统的气瓶安全监管方式已不适应气瓶安全监管工作的需要。为加强气瓶质量安全监管，构建以信息化为手段的气瓶安全监管方式，实现气瓶质量安全的全生命周期信息化管理、质量安全控制和追溯，保障气瓶安全使用。DB52/T 1669旨在确立气瓶质量安全追溯系统的相关要求，由四个部分组成。第 1 部分：通用要求。目的在于确定气瓶质量安全追溯系统的系统架构、监管平台、企业平台、数据体系、安全体系及管理体系的要求。第 2 部分：数据接口。目的在于确定气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数的要求。第 3 部分：气瓶信息化标签。目的在于确定
5、气瓶质量安全追溯系统气瓶信息化标签的功能要求、防伪特性、数据要求、安装要求和使用要求。第 4 部分：充装读写控制设备。目的在于确定气瓶质量安全追溯系统气瓶充装读写控制设备的要求。DB52/T 1669.22022 1 气瓶质量安全追溯系统 第 2 部分：数据接口 1 范围 本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最
6、新版本（包括所有的修改单）适用于本文件。GB/T 13000 信息技术 通用多八位编码字符集（UCS）RFC 2616 超文本传输协议1.1（Hypertext Transfer ProtocolHTTP/1.1）RFC 4627 JSON应用与媒体类型The application/json Media Type for JavaScript Object Notation(JSON)3 术语和定义 下列术语和定义适用于本文件。3.1 气瓶信息化标签 实现气瓶生命周期中充装验证和追溯的信息化媒介。3.2 编码字符集 一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。来
7、源：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：轻量级的数据交换格式（JavaScr
8、ipt Object Notation）MIME：多用途互联网邮件扩展（Multipurpose Internet Mail Extensions）DB52/T 1669.22022 2 5 总体要求 5.1 通信协议 应采用符合RFC 2616的HTTP或HTTPS。5.2 接口描述 宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。5.3 编码字符集 应符合GB/T 13000的要求。5.4 数据类型 气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：字符串型（String）；数字型（Number）；时间型（DateTime）；对象型（Object）；数组型（A
9、rray）；布尔型（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 请求的与实体对应的MIM
10、E信息 必选 Content-Lentgh 请求的内容长度 必选 DB52/T 1669.22022 3 表 1 （续）名称 描述 必选/可选 Cookie HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器 可选 User-Agent 内容包含发出请求的用户信息 可选 Token 访问连接的密钥信息 可选 6.1.3 请求参数 请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。示例：参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明-6.2 响应消息格式 6.2.1 消
11、息格式 响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。6.2.2 响应头 不同接口具有同一响应头，响应头的名称及其含义描述应符合表2的规定。表2 响应头 名称 描述 必选/可选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Length 请求的内容长度 必选 Date 服务器消息发出的时间 可选 Server 服务器软件名称 可选 6.2.3 响应参数 响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。示例：参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选
12、 对参数的描述及补充说明-7 接口基本功能和参数 7.1 接口流程 企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下：a)企业平台发出请求，上报数据或请求数据；b)监管平台对该次请求进行处理；DB52/T 1669.22022 4 c)处理后由监管平台向企业平台返回处理结果。图1 接口流程 7.2 初始化连通接口 7.2.1 功能 用于企业平台和监管平台间建立初始化连通。7.2.2 请求参数 初始化连通请求参数应符合表3的规定。表3 初始化连通请求参数 参数名 数据类型 必选/可选 描述 app_id String 必选 接入方ID app_key String 必选
13、接入方功能板块信息 app_secret String 必选 接入方密钥 7.2.3 响应消息参数 初始化连通响应消息参数应符合表4的规定。表4 初始化连通响应消息参数 参数名 数据类型 必选/可选 描述 status Number 必选 本次请求处理状态码 msg String 必选 本次请求处理结果描述 access_token String 必选 接入获取到的密钥 expries Number 必选 密钥过期时间 DB52/T 1669.22022 5 7.3 请求类接口 7.3.1 请求类接口列表 请求类接口列表应符合表5的规定。表5 请求类接口列表 中文名称 英文名称 必选/可选 气
14、瓶基本信息 product 必选 气瓶充装信息 fill 必选 气瓶检验信息 check 可选 气瓶信息化标签信息 tag 可选 7.3.2 请求类接口基本功能和参数 7.3.2.1 气瓶基本信息 7.3.2.1.1 功能 用于企业平台查询监管平台内气瓶基本信息。7.3.2.1.2 请求参数 气瓶基本信息请求参数应符合表6的规定。表6 气瓶基本信息请求参数 参数名 数据类型 必选/可选 描述 inner_code String 必选 查询气瓶的单位内编码 7.3.2.1.3 响应消息参数 气瓶基本信息响应信息参数应符合表7的规定。表7 气瓶基本信息响应消息参数 名称 数据类型 必选/可选 描述
15、 pro_variety String 必选 设备品种 pro_name String 必选 产品名称 pro_no String 必选 气瓶生产编号 fill_media Number 必选 充装介质：0 液化石油气，1 二甲醚，2 氧气，3 二氧化碳，4 溶解乙炔 make_unit String 必选 制造单位 make_time DateTime 必选 生产日期 work_pressure Number 必选 公称工作压（MPa）volume Number 必选 容积（L）check_time DateTime 必选 最近 次检验 日期（新瓶该值填写出厂日期）DB52/T 1669.2
16、2022 6 表7 （续）名称 数据类型 必选/可选 描述 next_check_time DateTime 必选 下次检验日期（液化石油气瓶顺延 4 年气瓶下一次需要送检验站检验的日期）regist_code String 可选 气瓶使登记代码 change_event String 可选 变更情况（主要记录产权过户日志）memo String 可选 备注 inner_code String 必选 单位内编号 stamp_make_unit String 可选 气瓶钢印制造单位名称 pro_uuid String 必选 产品唯一性编码 chip_id String 可选 芯片 id（每一个批次生成的登记证编号）location String 可选 归属地（客户、门店、气站、检测机构）：0001 门店，0002 气站，0003 企业，0004 检验机构，005 移动库，006 客户 status String 必选 气瓶状态在用（已检测）、停用（待检测）、报废：submit新瓶提交，using在用(已检测)，stop停用(待检测)，scrapped 报废 check_organizat
