ICS29.020CCSK09DB52/T1669.2—2022氣瓶質(zhì)量安全追溯系統(tǒng)第2部分：數(shù)據(jù)接口Part2：Datainterface2022-05-31發(fā)布2022-09-01實施貴州省市場監(jiān)督管理局發(fā)布IDB52/T1669.2—2022前言 12規(guī)范性引用文件 13術(shù)語和定義 14縮略語 1 26接口消息格式 27接口基本功能和參數(shù) 3參考文獻 DB52/T1669.2—2022DB52/T1669.2—2022本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件是DB52/T1669《氣瓶質(zhì)量安全追溯系統(tǒng)》的第2部分。DB52/T1669已經(jīng)發(fā)布了以下部分：——第1部分：通用要求；——第2部分：數(shù)據(jù)接口；——第3部分：氣瓶信息化標簽；——第4部分：充裝讀寫控制設(shè)備。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責(zé)任。本文件由貴州省市場監(jiān)督管理局提出并歸口。本文件起草單位：貴州省特種設(shè)備檢驗檢測院、貴州省市場監(jiān)督管理局、貴州由你想信息科技有限公司、貴州省市場監(jiān)管局大數(shù)據(jù)中心、六盤水市特種設(shè)備檢驗所、云南中石化燃氣有限公司、貴州四維燃氣有限公司、遵義市特種設(shè)備檢驗所、貴州省標準化院。本文件主要起草人：劉志鵬、張書輝、符文迪、馬祥、吳恒、王勃、劉安路、梁志、黃康、楊鵬、關(guān)志華、朱云樂、劉朝琴、陳江博、王澤西、王玲、潘勝榮、李煒、羅凌、徐超、呂根源、陳星源、聶印、文富聰、陳貴堂、游遠飛、潘昌亮、賈福波、韓霜、杭洪。DB52/T1669.2—2022氣瓶與人民群眾日常生活密切相關(guān)，直接關(guān)系到人民群眾的生命安全與生活質(zhì)量。隨著貴州經(jīng)濟社會高質(zhì)量發(fā)展，氣瓶數(shù)量急速增長，氣瓶泄漏或爆炸事件時有發(fā)生，對人民群眾生命財產(chǎn)安全造成了較大的潛在威脅，傳統(tǒng)的氣瓶安全監(jiān)管方式已不適應(yīng)氣瓶安全監(jiān)管工作的需要。為加強氣瓶質(zhì)量安全監(jiān)管，構(gòu)建以信息化為手段的氣瓶安全監(jiān)管方式，實現(xiàn)氣瓶質(zhì)量安全的全生命周期信息化管理、質(zhì)量安全控制和追溯，保障氣瓶安全使用。DB52/T1669旨在確立氣瓶質(zhì)量安全追溯系統(tǒng)的相關(guān)要求，由四個部分組成。——第1部分：通用要求。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)的系統(tǒng)架構(gòu)、監(jiān)管平臺、企業(yè)平臺、數(shù)據(jù)體系、安全體系及管理體系的要求?！?部分：數(shù)據(jù)接口。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)數(shù)據(jù)接口的總體要求、接口消息格式、接口基本功能和參數(shù)的要求?！?部分：氣瓶信息化標簽。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)氣瓶信息化標簽的功能要求、防偽特性、數(shù)據(jù)要求、安裝要求和使用要求?！?部分：充裝讀寫控制設(shè)備。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)氣瓶充裝讀寫控制設(shè)備DB52/T1669.2—20221氣瓶質(zhì)量安全追溯系統(tǒng)第2部分：數(shù)據(jù)接口本文件規(guī)定了氣瓶質(zhì)量安全追溯系統(tǒng)數(shù)據(jù)接口的總體要求、接口消息格式、接口基本功能和參數(shù)。本文件適用于液化石油氣氣瓶和液化二甲醚氣瓶的氣瓶質(zhì)量安全追溯系統(tǒng)的數(shù)據(jù)接口。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T13000信息技術(shù)通用多八位編碼字符集（UCS）RFC2616超文本傳輸協(xié)議1.1（HypertextTransferProtocol—HTTP/1.1）RFC4627JSON應(yīng)用與媒體類型[Theapplication/jsonMediaTypeforJavaScriptObjectNotation(JSON)]3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1氣瓶信息化標簽實現(xiàn)氣瓶生命周期中充裝驗證和追溯的信息化媒介。3.2編碼字符集一組明確的規(guī)則，它建立字符集和該字符集內(nèi)的字符與其位組之間一一對應(yīng)的關(guān)系。[來源：GB/T1988-1998，4.6]4縮略語下列縮略語適用于本文件。GTM：格林威治時間（GreenwichMeanTime）HTML：超文本置標語言（HyperTextMarkupLanguage）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer或HypertextTransferProtocolSecure）ID：標識符（Identifier）JSON：輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）MIME：多用途互聯(lián)網(wǎng)郵件擴展（MultipurposeInternetMailExtensions）2DB52/T1669.2—20225總體要求5.1通信協(xié)議應(yīng)采用符合RFC2616的HTTP或HTTPS。5.2接口描述宜使用標準化的或比較通用的文本描述語言，如JSON（RFC4627）。5.3編碼字符集應(yīng)符合GB/T13000的要求。5.4數(shù)據(jù)類型氣瓶質(zhì)量安全追溯系統(tǒng)數(shù)據(jù)接口應(yīng)覆蓋所能支持數(shù)據(jù)類型，包括：——字符串型（String）；——數(shù)字型（Number）；——時間型（DateTime）；——對象型（Object）；——數(shù)組型（Array——布爾型（Boolean）；——空（NULL）。6接口消息格式6.1請求消息格式6.1.1消息格式請求消息由請求頭和請求參數(shù)組成。應(yīng)使用HTTP規(guī)定的POST請求方法。6.1.2請求頭不同接口具有統(tǒng)一請求頭，請求頭的名稱及其含義描述應(yīng)符合表1的規(guī)定。表1請求頭DB52/T1669.2—20223HTTP請求發(fā)送時，會把保存在該請求域名下的所6.1.3請求參數(shù)請求參數(shù)格式見示例列表形式，根據(jù)不同接口功能，其請求參數(shù)不同。6.2響應(yīng)消息格式6.2.1消息格式響應(yīng)消息由響應(yīng)頭和響應(yīng)消息參數(shù)組成。應(yīng)使用HTTP規(guī)定的POST請求方法。6.2.2響應(yīng)頭不同接口具有同一響應(yīng)頭，響應(yīng)頭的名稱及其含義描述應(yīng)符合表2的規(guī)定。表2響應(yīng)頭6.2.3響應(yīng)參數(shù)響應(yīng)消息參數(shù)格式見示例列表形式，根據(jù)不同接口功能，其響應(yīng)消息參數(shù)不同。----7接口基本功能和參數(shù)7.1接口流程企業(yè)平臺向監(jiān)管平臺上報數(shù)據(jù)或請求數(shù)據(jù)的接口流程應(yīng)符合圖1，接口的流程如下：a)企業(yè)平臺發(fā)出請求，上報數(shù)據(jù)或請求數(shù)據(jù)；b)監(jiān)管平臺對該次請求進行處理；DB52/T1669.2—20224c)處理后由監(jiān)管平臺向企業(yè)平臺返回處理結(jié)果。圖1接口流程7.2初始化連通接口7.2.1功能用于企業(yè)平臺和監(jiān)管平臺間建立初始化連通。7.2.2請求參數(shù)初始化連通請求參數(shù)應(yīng)符合表3的規(guī)定。表3初始化連通請求參數(shù)7.2.3響應(yīng)消息參數(shù)初始化連通響應(yīng)消息參數(shù)應(yīng)符合表4的規(guī)定。表4初始化連通響應(yīng)消息參數(shù)DB52/T1669.2—202257.3請求類接口7.3.1請求類接口列表請求類接口列表應(yīng)符合表5的規(guī)定。表5請求類接口列表7.3.2請求類接口基本功能和參數(shù)氣瓶基本信息.1功能用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶基本信息。.2請求參數(shù)氣瓶基本信息請求參數(shù)應(yīng)符合表6的規(guī)定。表6氣瓶基本信息請求參數(shù).3響應(yīng)消息參數(shù)氣瓶基本信息響應(yīng)信息參數(shù)應(yīng)符合表7的規(guī)定。表7氣瓶基本信息響應(yīng)消息參數(shù)DB52/T1669.2—20226表7（續(xù)））：氣瓶充裝信息.1功能用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶最新一條充裝信息。DB52/T1669.2—2022.2請求參數(shù)氣瓶充裝信息請求參數(shù)應(yīng)符合表8的規(guī)定。表8氣瓶充裝信息請求參數(shù).3響應(yīng)消息參數(shù)氣瓶充裝信息響應(yīng)消息參數(shù)應(yīng)符合表9的規(guī)定。表9氣瓶充裝信息響應(yīng)消息參數(shù)氣瓶定期檢驗信息.1功能用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶最新檢驗信息。.2請求參數(shù)氣瓶定期檢驗信息請求參數(shù)應(yīng)符合表10的規(guī)定。表10氣瓶定期檢驗信息請求參數(shù).3響應(yīng)消息參數(shù)氣瓶定期檢驗信息響應(yīng)消息參數(shù)應(yīng)符合表11的規(guī)定，氣瓶定期檢驗明細應(yīng)符合表12的規(guī)定。DB52/T1669.2—20228表11氣瓶定期檢驗信息響應(yīng)消息參數(shù)表12氣瓶定期檢驗明細氣瓶信息化標簽信息.1功能用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶信息化標簽信息。.2請求參數(shù)氣瓶信息化標簽信息請求參數(shù)應(yīng)符合表13的規(guī)定。表13氣瓶信息化標簽信息請求參數(shù)DB52/T1669.2—2022.3響應(yīng)消息參數(shù)氣瓶信息化標簽信息響應(yīng)消息參數(shù)應(yīng)符合表14的規(guī)定。表14氣瓶信息化標簽信息響應(yīng)消息參數(shù)7.4上報類接口7.4.1上報類接口列表應(yīng)符合表15的規(guī)定。表15上報類接口列表7.4.2上報類接口基本功能和參數(shù)氣瓶流轉(zhuǎn)信息.1功能用于企業(yè)平臺向監(jiān)管平臺上報氣瓶信流轉(zhuǎn)過程的信息，包括氣瓶運輸信息、氣瓶倉儲信息、氣瓶配送信息。.2