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

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實(shí)施

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

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)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(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)簽

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

3.2

編碼字符集

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

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

4縮略語

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

GTM：格林威治時(shí)間（GreenwichMeanTime）

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

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

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

HypertextTransferProtocolSecure）

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

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

MIME：多用途互聯(lián)網(wǎng)郵件擴(kuò)展（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）；

——時(shí)間型（DateTime）；

——對(duì)象型（Object）；

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

——布爾型（Boolean）；

——空（NULL）。

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

6接口消息格式

6.1請(qǐng)求消息格式

6.1.1消息格式

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

6.1.2請(qǐng)求頭

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

表1請(qǐng)求頭

名稱描述必選/可選

Host指定請(qǐng)求的服務(wù)器的域名和端口號(hào)必選

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

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

Content-Type請(qǐng)求的與實(shí)體對(duì)應(yīng)的MIME信息必選

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

2

DB52/T1669.2—2022

表1（續(xù)）

名稱描述必選/可選

HTTP請(qǐng)求發(fā)送時(shí)，會(huì)把保存在該請(qǐng)求域名下的所有cookie

Cookie可選

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

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

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

6.1.3請(qǐng)求參數(shù)

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

示例：

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

給出該字段所代表的參數(shù)名用于描述數(shù)據(jù)的數(shù)據(jù)類型描述該參數(shù)是否為必選對(duì)參數(shù)的描述及補(bǔ)充說明

----

6.2響應(yīng)消息格式

6.2.1消息格式

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

6.2.2響應(yīng)頭

不同接口具有同一響應(yīng)頭，響應(yīng)頭的名稱及其含義描述應(yīng)符合表2的規(guī)定。

表2響應(yīng)頭

名稱描述必選/可選

Content-Type請(qǐng)求的與實(shí)體對(duì)應(yīng)的MIME信息必選

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

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

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

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

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

示例：

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

給出該字段所代表的參數(shù)名用于描述數(shù)據(jù)的數(shù)據(jù)類型描述該參數(shù)是否為必選對(duì)參數(shù)的描述及補(bǔ)充說明

----

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

7.1接口流程

企業(yè)平臺(tái)向監(jiān)管平臺(tái)上報(bào)數(shù)據(jù)或請(qǐng)求數(shù)據(jù)的接口流程應(yīng)符合圖1，接口的流程如下：

a)企業(yè)平臺(tái)發(fā)出請(qǐng)求，上報(bào)數(shù)據(jù)或請(qǐng)求數(shù)據(jù)；

b)監(jiān)管平臺(tái)對(duì)該次請(qǐng)求進(jìn)行處理；

3

DB52/T1669.2—2022

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

圖1接口流程

7.2初始化連通接口

7.2.1功能

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

7.2.2請(qǐng)求參數(shù)

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

表3初始化連通請(qǐng)求參數(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必選本次請(qǐng)求處理狀態(tài)碼

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

access_tokenString必選接入獲取到的密鑰

expriesNumber必選密鑰過期時(shí)間

4

DB52/T1669.2—2022

7.3請(qǐng)求類接口

7.3.1請(qǐng)求類接口列表

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

表5請(qǐng)求類接口列表

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

氣瓶基本信息product必選

氣瓶充裝信息fill必選

氣瓶檢驗(yàn)信息check可選

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

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

氣瓶基本信息

.1功能

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

.2請(qǐng)求參數(shù)

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

表6氣瓶基本信息請(qǐng)求參數(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)編號(hào)

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

fill_mediaNumber必選

化碳，4溶解乙炔

make_unitString必選制造單位

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

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

volumeNumber必選容積（L）

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

5

DB52/T1669.2—2022

表7（續(xù)）

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

下次檢驗(yàn)日期（液化石油氣瓶順延4年氣瓶下一次需

next_check_timeDateTime必選

要送檢驗(yàn)站檢驗(yàn)的日期）

regist_codeString可選氣瓶使?登記代碼

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

memoString可選備注

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

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

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

chip_idString可選芯片id（每一個(gè)批次生成的登記證編號(hào)）

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

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

006客戶

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

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

檢測(cè))，scrapped報(bào)廢

check_organizationString可選檢測(cè)機(jī)構(gòu)

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

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

uidString可選高頻編碼

tidString可選超高頻編碼

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

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

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

old_bottleBoolean必選是否舊瓶

design_thicknessNumber必選設(shè)計(jì)壁厚

result_codeString可選檢測(cè)結(jié)果

audit_remarkString可選審批備注

deadline_timeDateTime必選使用年限

check_in_timeDateTime必選錄入日期

scrap_timeDateTime可選報(bào)廢日期

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

analysis_statusString必選

scrapped報(bào)廢

check_statusBoolean必選1已證，0未證

operation_idString必選操作人id

operation_timeDateTime必選操作時(shí)間

safe_evaluateBoolean必選安全評(píng)定

氣瓶充裝信息

.1功能

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

6

DB52/T1669.2—2022

.2請(qǐng)求參數(shù)

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

表8氣瓶充裝信息請(qǐng)求參數(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必選充裝槍編號(hào)

station_idString必選充裝氣站ID

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

areaString必選所在區(qū)

cityString必選所在市

person_codeString必選充裝人員編碼

user_idString必選充裝人員id

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

chip_uidString必選高頻編碼

pro_uuidString必選氣瓶uuid

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

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

fill_timeDateTime必選充裝時(shí)間

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

氣瓶定期檢驗(yàn)信息

.1功能

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

.2請(qǐng)求參數(shù)

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

表10氣瓶定期檢驗(yàn)信息請(qǐng)求參數(shù)

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

order_noString必選氣瓶檢驗(yàn)訂單編號(hào)

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

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

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

7

DB52/T1669.2—2022

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

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

security_personString必選安全管理員

unit_phoneString必選單位固定電話

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

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

use_unit_addressString必選使用單位地址

use_unitString必選使用單位名稱

use_unit_fill_personString必選使用單位填表人員

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

use_unit_fill_dateDateTime必選填表日期

use_unit_phoneString必選移動(dòng)電話

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

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

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

batch_noString必選登記編號(hào)

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

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

check_statusNumber必選

3已綁定芯片，4報(bào)廢，5氣瓶退回，6氣瓶丟失

deal_flagBoolean必選是否完成檢驗(yàn)：0未完成，1已完成

is_safe_evaluateBoolean必選是否安全評(píng)定

next_check_timeDateTime可選下次檢驗(yàn)日期

scrap_typeString可選報(bào)廢處理方式

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

check_timeDateTime必選檢驗(yàn)時(shí)間

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

.1功能

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

.2請(qǐng)求參數(shù)

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

表13氣瓶信息化標(biāo)簽信息請(qǐng)求參數(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必選入庫時(shí)間

7.4上報(bào)類接口

7.4.1上報(bào)類接口列表

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

表15上報(bào)類接口列表

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

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

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

氣瓶流轉(zhuǎn)信息

.1功能

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

送信息。

.2請(qǐng)求參數(shù)

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

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

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

pro_uuidString必選氣瓶uuid

9

DB52/T1669.2—2022

表16（續(xù)）

名稱