氣瓶質量安全追溯系統2II目 次范圍 1規范性引用文件 1術語和定義 1縮略語 1總體要求 2接口消息格式 2接口基本功能和參數 3參考文獻 1111氣瓶質量安全追溯系統第2部分：數據接口范圍本文件規定了氣瓶質量安全追溯系統數據接口的總體要求、接口消息格式、接口基本功能和參數。本文件適用于液化石油氣氣瓶和液化二甲醚氣瓶的氣瓶質量安全追溯系統的數據接口。規范性引用文件（包括所有的修改單適用于本文件。GB/T13000 （UCS）RFC2616 超文本傳輸協議1.1（HypertextTransferProtocol—HTTP/1.1）RFC4627JSON應用與媒體類型[Theapplication/jsonMediaTypeforJavaScriptObjectNotation(JSON)]術語和定義下列術語和定義適用于本文件。3.1氣瓶信息化標簽實現氣瓶生命周期中充裝驗證和追溯的信息化媒介。3.2編碼字符集一組明確的規則，它建立字符集和該字符集內的字符與其位組之間一一對應的關系。[來源：GB/T1988-1998，4.6]縮略語下列縮略語適用于本文件。GTM：格林威治時間（GreenwichMeanTime）HTML：超文本置標語言（HyperTextMarkupHTTP：超文本傳輸協議（HyperTextTransferProtocol）HTTPS：超文本傳輸安全協議（HyperTextTransferProtocoloverSecureSocketLayer或HypertextTransferProtocolSecure）ID：標識符（Identifier）JSON：輕量級的數據交換格式（JavaScriptObjectNotation）MIME：多用途互聯網郵件擴展（MultipurposeInternetMail22總體要求通信協議應采用符合RFC2616的HTTP或HTTPS。接口描述宜使用標準化的或比較通用的文本描述語言，如JSON（RFC4627）。編碼字符集應符合GB/T13000的要求。數據類型氣瓶質量安全追溯系統數據接口應覆蓋所能支持數據類型，包括：——字符串型（String）；——數字型（Number）；——時間型（DateTime）；——對象型（Object）；——數組型（Array）；——布爾型（Boolean）；——空（NULL）。注：對“時間”類信息，以“1970年1月1日，00:00:00（GTM時間）”作為基準起始時間。接口消息格式請求消息格式消息格式請求消息由請求頭和請求參數組成。應使用HTTP規定的POST請求方法。請求頭不同接口具有統一請求頭，請求頭的名稱及其含義描述應符合表1的規定。表1請求頭名稱描述必選/可選Host指定請求的服務器的域名和端口號必選Connection表示是否需要持久連接必選Accept表示接受所接收的內容類型必選Content-Type請求的與實體對應的MIME信息必選Content-Lentgh請求的內容長度必選33表1（續）名稱描述必選/可選CookieHTTP請求發送時，會把保存在該請求域名下的所有cookie值一起發送給網站服務器可選User-Agent內容包含發出請求的用戶信息可選Token訪問連接的密鑰信息可選請求參數請求參數格式見示例列表形式，根據不同接口功能，其請求參數不同。示例：參數名數據類型必選/可選描述給出該字段所代表的參數名用于描述數據的數據類型描述該參數是否為必選對參數的描述及補充說明----響應消息格式消息格式響應消息由響應頭和響應消息參數組成。應使用HTTP規定的POST請求方法。響應頭不同接口具有同一響應頭，響應頭的名稱及其含義描述應符合表2的規定。表2響應頭名稱描述必選/可選Content-Type請求的與實體對應的MIME信息必選Content-Length請求的內容長度必選Date服務器消息發出的時間可選Server服務器軟件名稱可選響應參數響應消息參數格式見示例列表形式，根據不同接口功能，其響應消息參數不同。示例：參數名數據類型必選/可選描述給出該字段所代表的參數名用于描述數據的數據類型描述該參數是否為必選對參數的描述及補充說明----接口基本功能和參數接口流程企業平臺向監管平臺上報數據或請求數據的接口流程應符合圖1，接口的流程如下：企業平臺發出請求，上報數據或請求數據；監管平臺對該次請求進行處理；44處理后由監管平臺向企業平臺返回處理結果。圖1接口流程初始化連通接口功能用于企業平臺和監管平臺間建立初始化連通。請求參數初始化連通請求參數應符合表3的規定。表3初始化連通請求參數參數名數據類型必選/可選描述app_idString必選接入方IDapp_keyString必選接入方功能板塊信息app_secretString必選接入方密鑰響應消息參數初始化連通響應消息參數應符合表4的規定。表4初始化連通響應消息參數參數名數據類型必選/可選描述statusNumber必選本次請求處理狀態碼msgString必選本次請求處理結果描述access_tokenString必選接入獲取到的密鑰expriesNumber必選密鑰過期時間55請求類接口請求類接口列表請求類接口列表應符合表5的規定。表5請求類接口列表中文名稱英文名稱必選/可選氣瓶基本信息product必選氣瓶充裝信息fill必選氣瓶檢驗信息check可選氣瓶信息化標簽信息tag可選請求類接口基本功能和參數氣瓶基本信息功能用于企業平臺查詢監管平臺內氣瓶基本信息。請求參數氣瓶基本信息請求參數應符合表6的規定。表6氣瓶基本信息請求參數參數名數據類型必選/可選描述inner_codeString必選查詢氣瓶的單位內編碼響應消息參數氣瓶基本信息響應信息參數應符合表7的規定。表7氣瓶基本信息響應消息參數名稱數據類型必選/可選描述pro_varietyString必選設備品種pro_nameString必選產品名稱pro_noString必選氣瓶生產編號fill_mediaNumber必選充裝介質：0液化石油氣，1二甲醚，2氧氣，3二氧化碳，4溶解乙炔make_unitString必選制造單位make_timeDateTime必選生產日期work_pressureNumber必選公稱工作壓?（MPa）volumeNumber必選容積（L）check_timeDateTime必選最近?次檢驗?日期（新瓶該值填寫出廠日期）66表7（續）名稱數據類型必選/可選描述next_check_timeDateTime必選（4要送檢驗站檢驗的日期）regist_codeString可選氣瓶使登記代碼change_eventString可選變更情況（主要記錄產權過戶日志）memoString可選備注inner_codeString必選單位內編號stamp_make_unitString可選氣瓶鋼印制造單位名稱pro_uuidString必選產品唯一性編碼chip_idString可選芯片id（每一個批次生成的登記證編號）locationString可選（00010002006客戶statusString必選氣瓶狀態[在用（已檢測、停用（待檢測submitusingstop檢測)，scrapped報廢check_organizationString可選檢測機構empty_bottleBoolean必選是否空瓶：0是，1不是product_idString可選產品類型IDuidString可選高頻編碼tidString可選超高頻編碼chip_statusBoolean必選是否改造：0未改造，1已改造location_source_idString可選當前歸屬機構IDis_loseBoolean必選是否丟失：0丟失，1未丟失old_bottleBoolean必選是否舊瓶design_thicknessNumber必選設計壁厚result_codeString可選檢測結果audit_remarkString可選審批備注deadline_timeDateTime必選使用年限check_in_timeDateTime必選錄入日期scrap_timeDateTime可選報廢日期analysis_statusString必選統計狀態值：inform已提交待審批，using在用，scrapped報廢check_statusBoolean必選1已證，0未證operation_idString必選操作人idoperation_timeDateTime必選操作時間safe_evaluateBoolean必選安全評定氣瓶充裝信息功能用于企業平臺查詢監管平臺內氣瓶最新一條充裝信息。77請求參數氣瓶充裝信息請求參數應符合表8的規定。表8氣瓶充裝信息請求參數參數名數據類型必選/可選描述inner_codeString必選查詢氣瓶的單位內編碼響應消息參數氣瓶充裝信息響應消息參數應符合表9的規定。表9氣瓶充裝信息響應消息參數名稱數據類型必選/可選說明gun_codeString必選充裝槍編號station_idString必選充裝氣站IDcompany_idString必選充裝企業IDareaString必選所在區cityString必選所在市person_codeString必選充裝人員編碼user_idString必選充裝人員idinner_codeString必選單位內編號chip_uidString必選高頻編碼pro_uuidString必選氣瓶uuidproduct_idNumber必選產品類型idproduct_media_idNumber必選充裝介質編碼fill_timeDateTime必選充裝時間create_timeDateTime必選創建時間氣瓶定期檢驗信息功能用于企業平臺查詢監管平臺內氣瓶最新檢驗信息。請求參數氣瓶定期檢驗信息請求參數應符合表10的規定。表10氣瓶定期檢驗信息請求參數參數名數據類型必選/可選描述order_noString必選氣瓶檢驗訂單編號inner_codeString可選查詢氣瓶的單位內編碼響應消息參數氣瓶定期檢驗信息響應消息參數應符合表11的規定，氣瓶定期檢驗明細應符合表12的規定。88表11氣瓶定期檢驗信息響應消息參數名稱數據類型必選/可選說明security_personString必選安全管理員unit_phoneString必選單位固定電話pro_use_addressString必選設備使用單位地點pro_numNumber必選設備數量use_unit_addressString必選使用單位地址use_unitString必選使用單位名稱use_unit_fill_personString必選使用單位填表人員unit_social_codeString必選單位統一社會信用代碼use_unit_fill_dateDateTime必選填表日期use_unit_phoneString必選移動電話pro_listArray<Object>必選氣瓶定期檢驗明細表12氣瓶定期檢驗明細名稱數據類型必選/可選說明batch_noString必選登記編號ori_bottle_statusString必選原氣瓶狀態check_statusNumber必選03，4，5，6deal_flagBoolean必選是否完成檢驗：0未完成，1已完成is_safe_evaluateBoolean必選是否安全評定next_check_timeDateTime可選下次檢驗日期scrap_typeString可選報廢處理方式create_timeDateTime必選創建時間check_timeDateTime必選檢驗時間氣瓶信息化標簽信息功能用于企業平臺查詢監管平臺內氣瓶信息化標簽信息。請求參數氣瓶信息化標簽信息請求參數應符合表13的規定。表13氣瓶信息化標簽信息請求參數參數名數據類型必選/可選描述inner_codeString必選查詢氣瓶的單位內編碼99響應消息參數氣瓶信息化標簽信息響應消息參數應符合表14的規定。表14氣瓶信息化標簽信息響應消息參數名稱數據類型必選/可選說明uidString可選高頻編碼high_dataString可選高頻芯片塊數據tidString可選超高頻編碼ultra_high_dataString可選超高頻塊數據union_idString必選關聯idqr_idString可選二維碼idchip_keyString可選秘鑰status_idBoolean必選綁定狀態：0未綁定，1已綁定company_idString可選生產廠家create_timeDateTime必選入庫時間上報類接口上報類接口列表應符合表15的規定。表15上報類接口列表中文名稱英文名稱必選/可選氣瓶流轉信息circulation必選上報類接口基本功能和參數氣瓶流轉信息功能送信息。請求參數氣瓶流轉信息請求參數應符合表16的規定。表16氣瓶流轉信息請求參數名稱數據類型必選/可選說明pro_uuidString必選氣瓶uuid1010表16（續）名稱數據類型必選/可選說明inner_codeString可選氣瓶單位內編碼opt_typeString必選氣瓶操作類型：重瓶裝車，重瓶卸車，重瓶入庫，重瓶出庫，重瓶配送，空瓶回收，空瓶入庫，空瓶裝車，空瓶卸車memoString可選氣瓶操作說明op