ICS29.020

CCSK09

52

貴州省地方標準

DB52/T1669.2—2022

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

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

Qualityandsafetytraceabilitysystemforgascylinder—

Part2：Datainterface

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

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

DB52/T1669.2—2022

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

1范圍

本文件規(guī)定了氣瓶質量安全追溯系統(tǒng)數(shù)據接口的總體要求、接口消息格式、接口基本功能和參數(shù)。

本文件適用于液化石油氣氣瓶和液化二甲醚氣瓶的氣瓶質量安全追溯系統(tǒng)的數(shù)據接口。

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

下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T13000信息技術通用多八位編碼字符集（UCS）

RFC2616超文本傳輸協(xié)議1.1（HypertextTransferProtocol—HTTP/1.1）

RFC4627JSON應用與媒體類型[Theapplication/jsonMediaTypeforJavaScriptObject

Notation(JSON)]

3術語和定義

下列術語和定義適用于本文件。

3.1

氣瓶信息化標簽

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

3.2

編碼字符集

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

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

4縮略語

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

GTM：格林威治時間（GreenwichMeanTime）

HTML：超文本置標語言（HyperTextMarkupLanguage）

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

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

HypertextTransferProtocolSecure）

ID：標識符（Identifier）

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

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

1

DB52/T1669.2—2022

5總體要求

5.1通信協(xié)議

應采用符合RFC2616的HTTP或HTTPS。

5.2接口描述

宜使用標準化的或比較通用的文本描述語言，如JSON（RFC4627）。

5.3編碼字符集

應符合GB/T13000的要求。

5.4數(shù)據類型

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

——字符串型（String）；

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

——時間型（DateTime）；

——對象型（Object）；

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

——布爾型（Boolean）；

——空（NULL）。

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

6接口消息格式

6.1請求消息格式

6.1.1消息格式

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

6.1.2請求頭

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

表1請求頭

名稱描述必選/可選

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

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

Accept表示接受所接收的內容類型必選

Content-Type請求的與實體對應的MIME信息必選

Content-Lentgh請求的內容長度必選

2

DB52/T1669.2—2022

表1（續(xù)）

名稱描述必選/可選

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

Cookie可選

值一起發(fā)送給網站服務器

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

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

6.1.3請求參數(shù)

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

示例：

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

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

----

6.2響應消息格式

6.2.1消息格式

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

6.2.2響應頭

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

表2響應頭

名稱描述必選/可選

Content-Type請求的與實體對應的MIME信息必選

Content-Length請求的內容長度必選

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

Server服務器軟件名稱可選

6.2.3響應參數(shù)

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

示例：

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

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

----

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

7.1接口流程

企業(yè)平臺向監(jiān)管平臺上報數(shù)據或請求數(shù)據的接口流程應符合圖1，接口的流程如下：

a)企業(yè)平臺發(fā)出請求，上報數(shù)據或請求數(shù)據；

b)監(jiān)管平臺對該次請求進行處理；

3

DB52/T1669.2—2022

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

圖1接口流程

7.2初始化連通接口

7.2.1功能

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

7.2.2請求參數(shù)

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

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

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

app_idString必選接入方ID

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

app_secretString必選接入方密鑰

7.2.3響應消息參數(shù)

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

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

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

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

msgString必選本次請求處理結果描述

access_tokenString必選接入獲取到的密鑰

expriesNumber必選密鑰過期時間

4

DB52/T1669.2—2022

7.3請求類接口

7.3.1請求類接口列表

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

表5請求類接口列表

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

氣瓶基本信息product必選

氣瓶充裝信息fill必選

氣瓶檢驗信息check可選

氣瓶信息化標簽信息tag可選

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

氣瓶基本信息

.1功能

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

.2請求參數(shù)

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

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

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

inner_codeString必選查詢氣瓶的單位內編碼

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

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

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

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

pro_varietyString必選設備品種

pro_nameString必選產品名稱

pro_noString必選氣瓶生產編號

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

fill_mediaNumber必選

化碳，4溶解乙炔

make_unitString必選制造單位

make_timeDateTime必選生產日期

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

volumeNumber必選容積（L）

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

5

DB52/T1669.2—2022

表7（續(xù)）

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

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

next_check_timeDateTime必選

要送檢驗站檢驗的日期）

regist_codeString可選氣瓶使?登記代碼

change_eventString可選變更情況（主要記錄產權過戶日志）

memoString可選備注

inner_codeString必選單位內編號

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

pro_uuidString必選產品唯一性編碼

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

歸屬地（客戶、門店、氣站、檢測機構）：0001門店，

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

006客戶

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

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

檢測)，scrapped報廢

check_organizationString可選檢測機構

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

product_idString可選產品類型ID

uidString可選高頻編碼

tidString可選超高頻編碼

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

location_source_idString可選當前歸屬機構ID

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

old_bottleBoolean必選是否舊瓶

design_thicknessNumber必選設計壁厚

result_codeString可選檢測結果

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)管平臺內氣瓶最新一條充裝信息。

6

DB52/T1669.2—2022

.2請求參數(shù)

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

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

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

inner_codeString必選查詢氣瓶的單位內編碼

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

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

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

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

gun_codeString必選充裝槍編號

station_idString必選充裝氣站ID

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

areaString必選所在區(qū)

cityString必選所在市

person_codeString必選充裝人員編碼

user_idString必選充裝人員id

inner_codeString必選單位內編號

chip_uidString必選高頻編碼

pro_uuidString必選氣瓶uuid

product_idNumber必選產品類型id

product_media_idNumber必選充裝介質編碼

fill_timeDateTime必選充裝時間

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

氣瓶定期檢驗信息

.1功能

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

.2請求參數(shù)

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

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

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

order_noString必選氣瓶檢驗訂單編號

inner_codeString可選查詢氣瓶的單位內編碼

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

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

7

DB52/T1669.2—2022

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

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

security_personString必選安全管理員

unit_phoneString必選單位固定電話

pro_use_addressString必選設備使用單位地點

pro_numNumber必選設備數(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>必選氣瓶定期檢驗明細

表12氣瓶定期檢驗明細

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

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必選檢驗時間

氣瓶信息化標簽信息

.1功能

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

.2請求參數(shù)

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

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

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

inner_codeString必選查詢氣瓶的單位內編碼

8

DB52/T1669.2—2022

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

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

表14氣瓶信息化標簽信息響應消息參數(shù)

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

uidString可選高頻編碼

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

tidString可選超高頻編碼

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

union_idString必選關聯(lián)id

qr_idString可選二維碼id

chip_keyString可選秘鑰

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

company_idString可選生產廠家

create_timeDateTime必選入庫時間

7.4上報類接口

7.4.1上報類接口列表

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

表15上報類接口列表

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

氣瓶流轉信息circulation必選

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

氣瓶流轉信息

.1功能

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

送信息。

.2請求參數(shù)

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

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

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

pro_uuidString必選氣瓶uuid

9

DB52/T1669.2—2022

表16（續(xù)）

名稱