ICS29.020

CCSK09

52

貴州省地方標(biāo)準(zhǔn)

DB52/T1669.2—2022

氣瓶質(zhì)量安全追溯系統(tǒng)

第2部分：數(shù)據(jù)接口

Qualityandsafetytraceabilitysystemforgascylinder—

Part2：Datainterface

2022-05-31發(fā)布2022-09-01實施

貴州省市場監(jiān)督管理局發(fā)布

DB52/T1669.2—2022

目次

前言.................................................................................II

引言................................................................................III

1范圍...............................................................................1

2規(guī)范性引用文件.....................................................................1

3術(shù)語和定義.........................................................................1

4縮略語.............................................................................1

5總體要求...........................................................................2

6接口消息格式.......................................................................2

7接口基本功能和參數(shù).................................................................3

參考文獻.............................................................................11

I

DB52/T1669.2—2022

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件是DB52/T1669《氣瓶質(zhì)量安全追溯系統(tǒng)》的第2部分。DB52/T1669已經(jīng)發(fā)布了以下部分：

——第1部分：通用要求；

——第2部分：數(shù)據(jù)接口；

——第3部分：氣瓶信息化標(biāo)簽；

——第4部分：充裝讀寫控制設(shè)備。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由貴州省市場監(jiān)督管理局提出并歸口。

本文件起草單位：貴州省特種設(shè)備檢驗檢測院、貴州省市場監(jiān)督管理局、貴州由你想信息科技有限

公司、貴州省市場監(jiān)管局大數(shù)據(jù)中心、六盤水市特種設(shè)備檢驗所、云南中石化燃?xì)庥邢薰?、貴州四維

燃?xì)庥邢薰?、遵義市特種設(shè)備檢驗所、貴州省標(biāo)準(zhǔn)化院。

本文件主要起草人：劉志鵬、張書輝、符文迪、馬祥、吳恒、王勃、劉安路、梁志、黃康、楊鵬、

關(guān)志華、朱云樂、劉朝琴、陳江博、王澤西、王玲、潘勝榮、李煒、羅凌、徐超、呂根源、陳星源、聶

印、文富聰、陳貴堂、游遠飛、潘昌亮、賈福波、韓霜、杭洪。

II

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ù)體系、安全體系及管理體系的要求。

——第2部分：數(shù)據(jù)接口。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)數(shù)據(jù)接口的總體要求、接口消息

格式、接口基本功能和參數(shù)的要求。

——第3部分：氣瓶信息化標(biāo)簽。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)氣瓶信息化標(biāo)簽的功能要

求、防偽特性、數(shù)據(jù)要求、安裝要求和使用要求。

——第4部分：充裝讀寫控制設(shè)備。目的在于確定氣瓶質(zhì)量安全追溯系統(tǒng)氣瓶充裝讀寫控制設(shè)備

的要求。

III

DB52/T1669.2—2022

氣瓶質(zhì)量安全追溯系統(tǒng)第2部分：數(shù)據(jù)接口

1范圍

本文件規(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/jsonMediaTypeforJavaScriptObject

Notation(JSON)]

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

氣瓶信息化標(biāo)簽

實現(xiàn)氣瓶生命周期中充裝驗證和追溯的信息化媒介。

3.2

編碼字符集

一組明確的規(guī)則，它建立字符集和該字符集內(nèi)的字符與其位組之間一一對應(yīng)的關(guān)系。

[來源：GB/T1988-1998，4.6]

4縮略語

下列縮略語適用于本文件。

GTM：格林威治時間（GreenwichMeanTime）

HTML：超文本置標(biāo)語言（HyperTextMarkupLanguage）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer或

HypertextTransferProtocolSecure）

ID：標(biāo)識符（Identifier）

JSON：輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

MIME：多用途互聯(lián)網(wǎng)郵件擴展（MultipurposeInternetMailExtensions）

1

DB52/T1669.2—2022

5總體要求

5.1通信協(xié)議

應(yīng)采用符合RFC2616的HTTP或HTTPS。

5.2接口描述

宜使用標(biāo)準(zhǔn)化的或比較通用的文本描述語言，如JSON（RFC4627）。

5.3編碼字符集

應(yīng)符合GB/T13000的要求。

5.4數(shù)據(jù)類型

氣瓶質(zhì)量安全追溯系統(tǒng)數(shù)據(jù)接口應(yīng)覆蓋所能支持?jǐn)?shù)據(jù)類型，包括：

——字符串型（String）；

——數(shù)字型（Number）；

——時間型（DateTime）；

——對象型（Object）；

——數(shù)組型（Array）；

——布爾型（Boolean）；

——空（NULL）。

注：對“時間”類信息，以“1970年1月1日，00:00:00（GTM時間）”作為基準(zhǔn)起始時間。

6接口消息格式

6.1請求消息格式

6.1.1消息格式

請求消息由請求頭和請求參數(shù)組成。應(yīng)使用HTTP規(guī)定的POST請求方法。

6.1.2請求頭

不同接口具有統(tǒng)一請求頭，請求頭的名稱及其含義描述應(yīng)符合表1的規(guī)定。

表1請求頭

名稱描述必選/可選

Host指定請求的服務(wù)器的域名和端口號必選

Connection表示是否需要持久連接必選

Accept表示接受所接收的內(nèi)容類型必選

Content-Type請求的與實體對應(yīng)的MIME信息必選

Content-Lentgh請求的內(nèi)容長度必選

2

DB52/T1669.2—2022

表1（續(xù)）

名稱描述必選/可選

HTTP請求發(fā)送時，會把保存在該請求域名下的所有cookie

Cookie可選

值一起發(fā)送給網(wǎng)站服務(wù)器

User-Agent內(nèi)容包含發(fā)出請求的用戶信息可選

Token訪問連接的密鑰信息可選

6.1.3請求參數(shù)

請求參數(shù)格式見示例列表形式，根據(jù)不同接口功能，其請求參數(shù)不同。

示例：

參數(shù)名數(shù)據(jù)類型必選/可選描述

給出該字段所代表的參數(shù)名用于描述數(shù)據(jù)的數(shù)據(jù)類型描述該參數(shù)是否為必選對參數(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)頭

名稱描述必選/可選

Content-Type請求的與實體對應(yīng)的MIME信息必選

Content-Length請求的內(nèi)容長度必選

Date服務(wù)器消息發(fā)出的時間可選

Server服務(wù)器軟件名稱可選

6.2.3響應(yīng)參數(shù)

響應(yīng)消息參數(shù)格式見示例列表形式，根據(jù)不同接口功能，其響應(yīng)消息參數(shù)不同。

示例：

參數(shù)名數(shù)據(jù)類型必選/可選描述

給出該字段所代表的參數(shù)名用于描述數(shù)據(jù)的數(shù)據(jù)類型描述該參數(shù)是否為必選對參數(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)管平臺對該次請求進行處理；

3

DB52/T1669.2—2022

c)處理后由監(jiān)管平臺向企業(yè)平臺返回處理結(jié)果。

圖1接口流程

7.2初始化連通接口

7.2.1功能

用于企業(yè)平臺和監(jiān)管平臺間建立初始化連通。

7.2.2請求參數(shù)

初始化連通請求參數(shù)應(yīng)符合表3的規(guī)定。

表3初始化連通請求參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

app_idString必選接入方ID

app_keyString必選接入方功能板塊信息

app_secretString必選接入方密鑰

7.2.3響應(yīng)消息參數(shù)

初始化連通響應(yīng)消息參數(shù)應(yīng)符合表4的規(guī)定。

表4初始化連通響應(yīng)消息參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

statusNumber必選本次請求處理狀態(tài)碼

msgString必選本次請求處理結(jié)果描述

access_tokenString必選接入獲取到的密鑰

expriesNumber必選密鑰過期時間

4

DB52/T1669.2—2022

7.3請求類接口

7.3.1請求類接口列表

請求類接口列表應(yīng)符合表5的規(guī)定。

表5請求類接口列表

中文名稱英文名稱必選/可選

氣瓶基本信息product必選

氣瓶充裝信息fill必選

氣瓶檢驗信息check可選

氣瓶信息化標(biāo)簽信息tag可選

7.3.2請求類接口基本功能和參數(shù)

氣瓶基本信息

.1功能

用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶基本信息。

.2請求參數(shù)

氣瓶基本信息請求參數(shù)應(yīng)符合表6的規(guī)定。

表6氣瓶基本信息請求參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

inner_codeString必選查詢氣瓶的單位內(nèi)編碼

.3響應(yīng)消息參數(shù)

氣瓶基本信息響應(yīng)信息參數(shù)應(yīng)符合表7的規(guī)定。

表7氣瓶基本信息響應(yīng)消息參數(shù)

名稱數(shù)據(jù)類型必選/可選描述

pro_varietyString必選設(shè)備品種

pro_nameString必選產(chǎn)品名稱

pro_noString必選氣瓶生產(chǎn)編號

充裝介質(zhì)：0液化石油氣，1二甲醚，2氧氣，3二氧

fill_mediaNumber必選

化碳，4溶解乙炔

make_unitString必選制造單位

make_timeDateTime必選生產(chǎn)日期

work_pressureNumber必選公稱工作壓?（MPa）

volumeNumber必選容積（L）

check_timeDateTime必選最近?次檢驗?日期（新瓶該值填寫出廠日期）

5

DB52/T1669.2—2022

表7（續(xù)）

名稱數(shù)據(jù)類型必選/可選描述

下次檢驗日期（液化石油氣瓶順延4年氣瓶下一次需

next_check_timeDateTime必選

要送檢驗站檢驗的日期）

regist_codeString可選氣瓶使?登記代碼

change_eventString可選變更情況（主要記錄產(chǎn)權(quán)過戶日志）

memoString可選備注

inner_codeString必選單位內(nèi)編號

stamp_make_unitString可選氣瓶鋼印制造單位名稱

pro_uuidString必選產(chǎn)品唯一性編碼

chip_idString可選芯片id（每一個批次生成的登記證編號）

歸屬地（客戶、門店、氣站、檢測機構(gòu)）：0001門店，

locationString可選0002氣站，0003企業(yè)，0004檢驗機構(gòu)，005移動庫，

006客戶

氣瓶狀態(tài)[在用（已檢測）、停用（待檢測）、報廢]：

statusString必選submit新瓶提交，using在用(已檢測)，stop停用(待

檢測)，scrapped報廢

check_organizationString可選檢測機構(gòu)

empty_bottleBoolean必選是否空瓶：0是，1不是

product_idString可選產(chǎn)品類型ID

uidString可選高頻編碼

tidString可選超高頻編碼

chip_statusBoolean必選是否改造：0未改造，1已改造

location_source_idString可選當(dāng)前歸屬機構(gòu)ID

is_loseBoolean必選是否丟失：0丟失，1未丟失

old_bottleBoolean必選是否舊瓶

design_thicknessNumber必選設(shè)計壁厚

result_codeString可選檢測結(jié)果

audit_remarkString可選審批備注

deadline_timeDateTime必選使用年限

check_in_timeDateTime必選錄入日期

scrap_timeDateTime可選報廢日期

統(tǒng)計狀態(tài)值：inform已提交待審批，using在用，

analysis_statusString必選

scrapped報廢

check_statusBoolean必選1已證，0未證

operation_idString必選操作人id

operation_timeDateTime必選操作時間

safe_evaluateBoolean必選安全評定

氣瓶充裝信息

.1功能

用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶最新一條充裝信息。

6

DB52/T1669.2—2022

.2請求參數(shù)

氣瓶充裝信息請求參數(shù)應(yīng)符合表8的規(guī)定。

表8氣瓶充裝信息請求參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

inner_codeString必選查詢氣瓶的單位內(nèi)編碼

.3響應(yīng)消息參數(shù)

氣瓶充裝信息響應(yīng)消息參數(shù)應(yīng)符合表9的規(guī)定。

表9氣瓶充裝信息響應(yīng)消息參數(shù)

名稱數(shù)據(jù)類型必選/可選說明

gun_codeString必選充裝槍編號

station_idString必選充裝氣站ID

company_idString必選充裝企業(yè)ID

areaString必選所在區(qū)

cityString必選所在市

person_codeString必選充裝人員編碼

user_idString必選充裝人員id

inner_codeString必選單位內(nèi)編號

chip_uidString必選高頻編碼

pro_uuidString必選氣瓶uuid

product_idNumber必選產(chǎn)品類型id

product_media_idNumber必選充裝介質(zhì)編碼

fill_timeDateTime必選充裝時間

create_timeDateTime必選創(chuàng)建時間

氣瓶定期檢驗信息

.1功能

用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶最新檢驗信息。

.2請求參數(shù)

氣瓶定期檢驗信息請求參數(shù)應(yīng)符合表10的規(guī)定。

表10氣瓶定期檢驗信息請求參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

order_noString必選氣瓶檢驗訂單編號

inner_codeString可選查詢氣瓶的單位內(nèi)編碼

.3響應(yīng)消息參數(shù)

氣瓶定期檢驗信息響應(yīng)消息參數(shù)應(yīng)符合表11的規(guī)定，氣瓶定期檢驗明細(xì)應(yīng)符合表12的規(guī)定。

7

DB52/T1669.2—2022

表11氣瓶定期檢驗信息響應(yīng)消息參數(shù)

名稱數(shù)據(jù)類型必選/可選說明

security_personString必選安全管理員

unit_phoneString必選單位固定電話

pro_use_addressString必選設(shè)備使用單位地點

pro_numNumber必選設(shè)備數(shù)量

use_unit_addressString必選使用單位地址

use_unitString必選使用單位名稱

use_unit_fill_personString必選使用單位填表人員

unit_social_codeString必選單位統(tǒng)一社會信用代碼

use_unit_fill_dateDateTime必選填表日期

use_unit_phoneString必選移動電話

pro_listArray<Object>必選氣瓶定期檢驗明細(xì)

表12氣瓶定期檢驗明細(xì)

名稱數(shù)據(jù)類型必選/可選說明

batch_noString必選登記編號

ori_bottle_statusString必選原氣瓶狀態(tài)

檢驗狀態(tài)：0送檢，1待綁定銘牌，2待綁定芯片，

check_statusNumber必選

3已綁定芯片，4報廢，5氣瓶退回，6氣瓶丟失

deal_flagBoolean必選是否完成檢驗：0未完成，1已完成

is_safe_evaluateBoolean必選是否安全評定

next_check_timeDateTime可選下次檢驗日期

scrap_typeString可選報廢處理方式

create_timeDateTime必選創(chuàng)建時間

check_timeDateTime必選檢驗時間

氣瓶信息化標(biāo)簽信息

.1功能

用于企業(yè)平臺查詢監(jiān)管平臺內(nèi)氣瓶信息化標(biāo)簽信息。

.2請求參數(shù)

氣瓶信息化標(biāo)簽信息請求參數(shù)應(yīng)符合表13的規(guī)定。

表13氣瓶信息化標(biāo)簽信息請求參數(shù)

參數(shù)名數(shù)據(jù)類型必選/可選描述

inner_codeString必選查詢氣瓶的單位內(nèi)編碼

8

DB52/T1669.2—2022

.3響應(yīng)消息參數(shù)

氣瓶信息化標(biāo)簽信息響應(yīng)消息參數(shù)應(yīng)符合表14的規(guī)定。

表14氣瓶信息化標(biāo)簽信息響應(yīng)消息參數(shù)

名稱數(shù)據(jù)類型必選/可選說明

uidString可選高頻編碼

high_dataString可選高頻芯片塊數(shù)據(jù)

tidString可選超高頻編碼

ultra_high_dataString可選超高頻塊數(shù)據(jù)

union_idString必選關(guān)聯(lián)id

qr_idString可選二維碼id

chip_keyString可選秘鑰

status_idBoolean必選綁定狀態(tài)：0未綁定，1已綁定

company_idString可選生產(chǎn)廠家

create_timeDateTime必選入庫時間

7.4上報類接口

7.4.1上報類接口列表

應(yīng)符合表15的規(guī)定。

表15上報類接口列表

中文名稱英文名稱必選/可選

氣瓶流轉(zhuǎn)信息circulation必選

7.4.2上報類接口基本功能和參數(shù)

氣瓶流轉(zhuǎn)信息

.1功能

用于企業(yè)平臺向監(jiān)管平臺上報氣瓶信流轉(zhuǎn)過程的信息，包括氣瓶運輸信息、氣瓶倉儲信息、氣瓶配

送信息。

.2請求參數(shù)

氣瓶流轉(zhuǎn)信息請求參數(shù)應(yīng)符合表16的規(guī)定。

表16氣瓶流轉(zhuǎn)信息請求參數(shù)

名稱數(shù)據(jù)類型必選/可選說明

pro_uuidString必選氣瓶uuid