安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)數(shù)據(jù)接口規(guī)范

ICS點(diǎn)擊此處添加ICS號(hào)

點(diǎn)擊此處添加中國(guó)標(biāo)準(zhǔn)文獻(xiàn)分類(lèi)號(hào)

DB34

安徽省地方標(biāo)準(zhǔn)

DB34/XXXXX—XXXX

安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)數(shù)據(jù)接

口規(guī)范

DataInterfaceSpecificationforGasCylinderSafetyTraceabilityofAn

hui

點(diǎn)擊此處添加與國(guó)際標(biāo)準(zhǔn)一致性程度的標(biāo)識(shí)

文稿版次選擇

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

安徽省市場(chǎng)監(jiān)督管理局發(fā)布

■TZ■■■

刖百

本標(biāo)準(zhǔn)依據(jù)GB/T1.1-2020給出的規(guī)則起草。

本標(biāo)準(zhǔn)由安徽省特種設(shè)備檢測(cè)院提出。

本標(biāo)準(zhǔn)由安徽省市場(chǎng)監(jiān)督管理局歸口。

本標(biāo)準(zhǔn)起草單位：安徽省特種設(shè)備檢測(cè)院、科大國(guó)創(chuàng)云網(wǎng)科技有限公司。

本標(biāo)準(zhǔn)主要起草人：王恩和、馮強(qiáng)中、莫誠(chéng)生、吳春、李軍、許佳偉。

安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)數(shù)據(jù)接口規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)的數(shù)據(jù)交換架構(gòu)、數(shù)據(jù)交換環(huán)境、數(shù)據(jù)

交換模式、接口總則、接口響應(yīng)狀態(tài)編碼、接口協(xié)議約定及協(xié)議清單、接口協(xié)議的內(nèi)容，適

用于省、市及氣瓶充裝單位、檢驗(yàn)單位之間關(guān)于氣瓶質(zhì)量安全追溯要求的數(shù)據(jù)交換，同時(shí)適

用于安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)的建設(shè)單位、研發(fā)單位的系統(tǒng)開(kāi)發(fā)、平臺(tái)對(duì)接、接口

測(cè)試、系統(tǒng)驗(yàn)收工作。

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

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本

適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法

GB/T13005-2011氣瓶術(shù)語(yǔ)

GB/T36373.1-2018特種設(shè)備信息資源管理數(shù)據(jù)元規(guī)范第1部分：氣瓶

TSG08-2017特種設(shè)備使用管理規(guī)則

TSG23-2021氣瓶安全技術(shù)規(guī)程

TSG07-2019特種設(shè)備生產(chǎn)和充裝單位許可規(guī)則

TSGZ6001-2019特種設(shè)備作業(yè)人員考核規(guī)則

3術(shù)語(yǔ)和定義

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

設(shè)備品種：按照TSG23-2021和特種設(shè)備目錄規(guī)定，氣瓶品種分為無(wú)縫氣瓶、焊接氣瓶、

特種氣瓶（內(nèi)裝燃料氣瓶、纖維纏繞氣瓶、低溫絕熱氣瓶）

氣瓶類(lèi)型：本標(biāo)準(zhǔn)中定義氣瓶類(lèi)型按照使用用途及業(yè)務(wù)范圍進(jìn)行分類(lèi)，包括液化石油氣

瓶、車(chē)用氣瓶和_L業(yè)用氣瓶，不包括醫(yī)用氣瓶、呼吸器用氣瓶和消防火火用氣瓶

HTTP：是指超文本傳輸協(xié)議是一個(gè)簡(jiǎn)單的請(qǐng)求?響應(yīng)協(xié)議，它指定了客戶端發(fā)送給服務(wù)

器的消息以及響應(yīng)內(nèi)容，是一種通用的應(yīng)用數(shù)據(jù)傳輸協(xié)議。

4數(shù)據(jù)交換架構(gòu)

省、市、氣瓶充裝或檢驗(yàn)單位的氣瓶質(zhì)量安全追溯信息平臺(tái)可通過(guò)三級(jí)數(shù)據(jù)交換架構(gòu)形

式進(jìn)行，省級(jí)平臺(tái)為省級(jí)部門(mén)提供數(shù)據(jù)服務(wù)支撐，與各市級(jí)平臺(tái)互聯(lián)互通：市級(jí)平臺(tái)為市級(jí)

部門(mén)提供數(shù)據(jù)服務(wù)支撐，與各充裝單位或檢驗(yàn)站單位互聯(lián)互通；省級(jí)平臺(tái)也可直接與各充裝

單位或檢驗(yàn)站單位互聯(lián)互通。

數(shù)據(jù)交換架構(gòu)如圖1所示：

省級(jí)平臺(tái)

王式庫(kù)省級(jí)前置庫(kù)交換節(jié)點(diǎn)

政

務(wù)

專(zhuān)

網(wǎng)

/市級(jí)平臺(tái)目室?

互工^庫(kù)市級(jí)前置庫(kù)交換節(jié)點(diǎn)

聯(lián)

網(wǎng)

充裝/

檢驗(yàn)單

位平臺(tái)

圖1數(shù)據(jù)交換架構(gòu)體系圖

省級(jí)平臺(tái)建立數(shù)據(jù)交換節(jié)點(diǎn)或通過(guò)前置機(jī)部署數(shù)據(jù)庫(kù)，開(kāi)通市級(jí)、充裝單位和檢驗(yàn)單位

接口調(diào)用權(quán)限或數(shù)據(jù)庫(kù)訪問(wèn)權(quán)限，完成各自平臺(tái)數(shù)據(jù)的雙向交換；

市級(jí)平臺(tái)建立數(shù)據(jù)交換節(jié)點(diǎn)或通過(guò)前置機(jī)部署數(shù)據(jù)庫(kù)，開(kāi)通充裝單位和檢驗(yàn)單位的平臺(tái)

接口調(diào)用權(quán)限或數(shù)據(jù)庫(kù)訪問(wèn)權(quán)限，完成各自平臺(tái)數(shù)據(jù)的雙向交換；

5數(shù)據(jù)交換環(huán)境要求

安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)數(shù)據(jù)交換應(yīng)優(yōu)先依托于政務(wù)外網(wǎng)進(jìn)行，省、市、充裝

單位/檢驗(yàn)單位三級(jí)平臺(tái)應(yīng)當(dāng)優(yōu)先利用電子政務(wù)外網(wǎng)開(kāi)放必須的通信端口，整個(gè)數(shù)據(jù)交換體

系架構(gòu)支持互聯(lián)網(wǎng)接口請(qǐng)求與調(diào)用。

5.1網(wǎng)絡(luò)環(huán)境應(yīng)滿足如下要求

a）宜采用電子政務(wù)外網(wǎng)或滿足要求的互聯(lián)網(wǎng)；

b）網(wǎng)絡(luò)帶寬不宜低于50Mbps；

c）網(wǎng)絡(luò)環(huán)境需長(zhǎng)期穩(wěn)定；

5.2交換節(jié)點(diǎn)應(yīng)滿足如下要求

d）宜采用專(zhuān)用設(shè)備；

e）性能要求，CPU4核、內(nèi)存8G：

f）交換節(jié)點(diǎn)需安全可靠。

6數(shù)據(jù)交換模式

6.1基于HTTP協(xié)議的接口調(diào)用

6.1.1該調(diào)用方式適用于獲取實(shí)時(shí)性、小數(shù)據(jù)包、結(jié)構(gòu)化、非結(jié)構(gòu)化、半結(jié)構(gòu)化的數(shù)

據(jù)，以及具備接口調(diào)用存儲(chǔ)能力的系統(tǒng)。接口調(diào)用流程應(yīng)符合圖2的要求，詳細(xì)的接口清單

及約定內(nèi)容見(jiàn)《附錄A氣瓶質(zhì)品安全追溯信息平臺(tái)HTTP接口協(xié)議要求》

否

圖2接I」調(diào)用流程圖

圖中的服務(wù)方表示提供接口服務(wù)的一方；調(diào)用方表示需要進(jìn)行接口調(diào)用的一方；

調(diào)用方在調(diào)用接口前需向服務(wù)方申請(qǐng)調(diào)用權(quán)限，可預(yù)先提供調(diào)用方的相關(guān)信息，以獲

取服務(wù)方提供的用戶識(shí)別碼，調(diào)用方再根據(jù)用戶識(shí)別碼鑒權(quán)獲取接口服務(wù)的授權(quán)碼，從而

進(jìn)行接口的訪問(wèn)調(diào)用，返回的接口響應(yīng)狀態(tài)編碼詳情見(jiàn)第9章。

6.2基于數(shù)據(jù)抽取服務(wù)的數(shù)據(jù)交換

6.2.1數(shù)據(jù)抽取服務(wù)的交換方式一般用于數(shù)據(jù)量大、實(shí)時(shí)性要求不高、不具備HTTP

接口調(diào)用能力或局域網(wǎng)部署的周期性、結(jié)構(gòu)化的數(shù)據(jù)場(chǎng)景。數(shù)據(jù)庫(kù)抽取的流程應(yīng)符合圖3的

要求：

（數(shù)據(jù)庫(kù)交換》

〈節(jié)點(diǎn)1>交換通道（節(jié)點(diǎn)2>

根據(jù)數(shù)據(jù)交換分e根據(jù)數(shù)據(jù)交換

②

標(biāo)準(zhǔn)細(xì)織教據(jù)出標(biāo)準(zhǔn)組織數(shù)據(jù)

并篤人代點(diǎn)機(jī)一寫(xiě)入<??數(shù)據(jù)獲取?一??7人??川認(rèn)海涮

前置翻據(jù)庫(kù)—岸

前置數(shù)據(jù)前置數(shù)據(jù)

交換傳輸控制

庫(kù)庫(kù)

③③

???費(fèi)據(jù)接收-■■■—數(shù)據(jù)接收f(shuō)

―?節(jié)點(diǎn)1發(fā)送盤(pán)據(jù)給節(jié)點(diǎn)2>節(jié)點(diǎn)2發(fā)送數(shù)據(jù)給節(jié)點(diǎn)1

圖3數(shù)據(jù)抽取示意圖

數(shù)據(jù)提供方按照預(yù)先制定的標(biāo)準(zhǔn)數(shù)據(jù)結(jié)構(gòu)寫(xiě)入數(shù)據(jù)，與數(shù)據(jù)接收方約定數(shù)據(jù)抽取規(guī)則

并提供數(shù)據(jù)庫(kù)訪問(wèn)權(quán)限，數(shù)據(jù)接收方按照約定內(nèi)容進(jìn)行數(shù)據(jù)抽取并回執(zhí)數(shù)據(jù)獲取狀態(tài)。對(duì)

接的數(shù)據(jù)內(nèi)容見(jiàn)《附錄B安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)數(shù)據(jù)交換內(nèi)容》

7數(shù)據(jù)集成要求

7.1數(shù)據(jù)交換對(duì)接要求

a）對(duì)接時(shí)，接口服務(wù)方及調(diào)用方應(yīng)積極配合完成軟硬件的安裝部署和網(wǎng)絡(luò)聯(lián)通工

作，以及做相應(yīng)的調(diào)試、驗(yàn)證工作；

b）聯(lián)調(diào)并測(cè)試通過(guò)后，切換正式環(huán)境，各市和充裝站/檢驗(yàn)站系統(tǒng)開(kāi)始正式上傳或讀

取下載數(shù)據(jù)。

7.2接口維護(hù)及巡檢要求

各接口服務(wù)方及調(diào)用方均應(yīng)建立完善的巡檢和維護(hù)管理制度，服務(wù)方如接口需調(diào)整，應(yīng)

當(dāng)至少提前2個(gè)工作日通知接口調(diào)用方，告知接口調(diào)整情況。為保障接口和前置庫(kù)程序能正

常使用，安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)應(yīng)提供定期巡檢制度以供參考，詳情如下：

分類(lèi)巡檢項(xiàng)建議處理措施

設(shè)備停機(jī)、死機(jī)聯(lián)系接口服務(wù)方查看故障原因，重啟設(shè)備

硬件

CPU、內(nèi)存、硬盤(pán)空間不足聯(lián)系接口服務(wù)方查看硬件使用情況，合理擴(kuò)容

網(wǎng)絡(luò)不通核實(shí)網(wǎng)絡(luò)、端口訪問(wèn)是否正確有效

接口接口報(bào)錯(cuò)聯(lián)系接口服務(wù)方查看報(bào)錯(cuò)日志并處理

接口運(yùn)行緩慢聯(lián)系接口服務(wù)方查看解接口運(yùn)行日志并處理

接口數(shù)據(jù)丟失或內(nèi)容錯(cuò)誤聯(lián)系接口服務(wù)方核實(shí)數(shù)據(jù)來(lái)源和是否存在積壓情況

操作系統(tǒng)病毒入侵聯(lián)系接口服務(wù)方查看病毒問(wèn)題并解決

7.3前置庫(kù)數(shù)據(jù)處理及同步要求

考慮服務(wù)器資源，前置庫(kù)多用于待交換數(shù)據(jù)臨時(shí)存放，省、市級(jí)應(yīng)對(duì)本級(jí)交換節(jié)點(diǎn)上的

前置庫(kù)數(shù)據(jù)進(jìn)行定期刪除，原則上要求數(shù)據(jù)僅存1個(gè)月，且定期進(jìn)行全量數(shù)據(jù)的同步工作。

8接口基本要求

8.1同步異步接口使用原則

采用同步方式進(jìn)行接口交互。

8.2接口異常響應(yīng)提示信息原則

8.2.1接口異常響應(yīng)提示信息應(yīng)符合以下原則：

a）接口異常響應(yīng)中，能夠明確的錯(cuò)誤信息一定要表述清楚，并把詳細(xì)報(bào)錯(cuò)信息記錄到

日志。

b）接口異常響應(yīng)中的錯(cuò)誤提示信息，應(yīng)通俗易懂。

c）錯(cuò)誤日志中需要記錄路由信息（包括請(qǐng)求唯一標(biāo)識(shí)等）,供運(yùn)維人員排查問(wèn)題使用。

8.3前置庫(kù)對(duì)接協(xié)同說(shuō)明

源數(shù)據(jù)提供方和目標(biāo)數(shù)據(jù)接收方明確表的結(jié)構(gòu)、名稱(chēng)以及傳輸時(shí)間后，接收方應(yīng)及時(shí)建

表，并提供具有該表讀寫(xiě)權(quán)限的賬號(hào)信息，以及相對(duì)應(yīng)的地址、端口、實(shí)例/庫(kù)名稱(chēng)；源數(shù)據(jù)

提供方按照給定的連接信息建立ETL腳本清洗、轉(zhuǎn)換、抽取、同步程序。

9接口響應(yīng)狀態(tài)編碼

接口響應(yīng)狀態(tài)編碼要求如表2所示。

表2接口相應(yīng)狀態(tài)編碼表

狀態(tài)碼說(shuō)明

200成功

101路由字段不存在

201服務(wù)器已經(jīng)接受請(qǐng)求，但尚未處理

202服務(wù)小可用

203單次調(diào)用包大小超過(guò)指定閥值

204流量超過(guò)閥值

205調(diào)用頻次過(guò)快

206并發(fā)超過(guò)閥值

207IP鑒權(quán)異常

208授權(quán)碼無(wú)效

209授權(quán)碼超時(shí)

210報(bào)文轉(zhuǎn)換異常

301服務(wù)端連接異常

302服務(wù)端連接超時(shí)

303服務(wù)端內(nèi)部異常

304服務(wù)端請(qǐng)求超時(shí)

400服務(wù)器拒絕請(qǐng)求，不能理解請(qǐng)求語(yǔ)法

401測(cè)試接口未實(shí)現(xiàn)

404服務(wù)器拒絕請(qǐng)求，該服務(wù)不存在

600服務(wù)器遇到錯(cuò)誤，無(wú)法完成請(qǐng)求

999未知異常

附錄A

（規(guī)范性附錄）

安徽省氣瓶質(zhì)量安全追溯信息平臺(tái)HTTP接口協(xié)議要求

9.1接口申報(bào)要求

9.1.1接口申報(bào)應(yīng)符合如下要求

a）接口服務(wù)方需提供接口服務(wù)器地址及端口；

b）協(xié)議格式：接口服務(wù)器地址:端口號(hào)/平臺(tái)英文名稱(chēng)/分類(lèi)英文名稱(chēng)/接口英文名稱(chēng)？

211訃01422第0"授權(quán)碼，其中分類(lèi)名稱(chēng)和接口名稱(chēng)詳情見(jiàn)1.5節(jié)，授權(quán)碼在訪問(wèn)

獲取授權(quán)碼時(shí)獲得：

例：hlip:〃接口服務(wù)器地址：端口號(hào)/平臺(tái)英文名稱(chēng)/comm/gelDicl?auIhorizalion=090988778899809

（獲取數(shù)據(jù)字典）

c）用戶識(shí)別碼由接口服務(wù)方平臺(tái)統(tǒng)一提供，接口對(duì)接期間長(zhǎng)期有效；

d）接口授權(quán)碼是針對(duì)每個(gè)接口服務(wù)，為保障接口調(diào)用的安全性，一般具有時(shí)效性限制：

e）接口數(shù)據(jù)模型定義的必填項(xiàng)必須提供；

f）上傳數(shù)據(jù)前應(yīng)建立校驗(yàn)數(shù)據(jù)重復(fù)性的機(jī)制，避免數(shù)據(jù)重復(fù)插入；

g）無(wú)特殊說(shuō)明，接口默認(rèn)采用HTTPPOST方法；

h）接口應(yīng)具備防越權(quán)，防篡改，防重放，敏感信息防泄漏等安全性要求。

9.2接口日志記錄要求

每次調(diào)用，接口調(diào)用方、接口提供方均應(yīng)記錄接口的調(diào)用日志，日志內(nèi)容至少包含調(diào)用

開(kāi)始結(jié)束時(shí)間、調(diào)用接口地址、調(diào)用參數(shù)、調(diào)用者IP及調(diào)用的通訊情況。日志記錄后，可以

根據(jù)請(qǐng)求唯一標(biāo)識(shí)查詢(xún)到詳細(xì)的日志記錄。

9.3接口異常處理要求

捕獲

異常

各系統(tǒng)（包括接口調(diào)用方、接口提供方）在捕獲異常后，異常的處理遵循能處理就處理，

不能處理就封裝并向上傳遞，如果不能傳遞就告警并人工處理的原則。

當(dāng)調(diào)用接口時(shí)，如果因?yàn)榫W(wǎng)絡(luò)異常等數(shù)據(jù)傳輸錯(cuò)誤而造成數(shù)據(jù)未送達(dá)對(duì)端時(shí)，建議接口

調(diào)用方進(jìn)行?定數(shù)量的重試。

當(dāng)調(diào)用接口時(shí)，如果數(shù)據(jù)已經(jīng)送達(dá)對(duì)端，因?yàn)閿?shù)據(jù)本身存在錯(cuò)誤而無(wú)法處理時(shí)，接口被

調(diào)用方應(yīng)該將詳細(xì)的錯(cuò)誤信息返回給接口調(diào)用方，并盡量明確的告知數(shù)據(jù)錯(cuò)誤的具體原因。

9.4其他要求

a）HTTP接口協(xié)議版本：HTTP協(xié)議版本為1.1及以上。

b）字符集統(tǒng)一采用UTF-8格式；

c）接口調(diào)用，單次文件包大小應(yīng)小于30M

9.5協(xié)議清單

分類(lèi)名稱(chēng)英文名稱(chēng)說(shuō)明

通用應(yīng)用conun系統(tǒng)內(nèi)相關(guān)的配置信息、單位、人員信息、系統(tǒng)鑒權(quán)信息等

液化氣瓶管理yhqp液化氣瓶管理方面的接口

車(chē)用氣瓶管理cyqp車(chē)用氣瓶管理方面的接口

工業(yè)氣瓶管理gyqp工業(yè)氣瓶管理方面的接口

分類(lèi)接口名稱(chēng)英文名稱(chēng)說(shuō)明

通用應(yīng)用獲取授權(quán)碼接口getTicket獲取授權(quán)碼以訪問(wèn)接口

通用應(yīng)用獲取數(shù)據(jù)字典getDict獲取數(shù)據(jù)字典，如充裝介質(zhì)、標(biāo)簽類(lèi)

型、氣瓶種類(lèi)、氣瓶型號(hào)、氣瓶品種

等

通用應(yīng)用獲取制造單位信息getProduceUnit獲取液化氣瓶、工業(yè)氣瓶、車(chē)用氣瓶

的制造單位信息

通用應(yīng)用獲取單位信息getUnit獲取液化氣瓶、工業(yè)氣瓶、車(chē)用氣瓶

充裝單位、檢驗(yàn)單位信息

通用應(yīng)用獲取人員信息getOperators獲取氣瓶充裝人員、安全管理人員

及檢驗(yàn)人員的信息

通用應(yīng)用上傳文件接口upFile上傳氣瓶證明材料、人員資質(zhì)材料、

制造單位資質(zhì)材料

液化氣瓶管獲取氣瓶檔案數(shù)據(jù)getYhqpList氣瓶品種、產(chǎn)品編號(hào)、型號(hào)等信息

理獲取氣瓶檢驗(yàn)記錄getYhqpChecklnfo氣瓶制造檢驗(yàn)、定檢信息

獲取氣瓶充裝前后檢查記錄getYhqpFillingChecklnfo氣瓶充前檢查、充后檢查錄入的信

息

獲取氣瓶充裝記錄getYhqpEi11ingInfo氣瓶充裝時(shí)間、充裝量信息

獲取報(bào)廢氣瓶信息getYhqpScrapInfo氣瓶報(bào)廢時(shí)間、狀態(tài)

上傳氣瓶檔案數(shù)據(jù)upYhqpList-

上傳氣瓶檢驗(yàn)記錄upYhqpChccklnfo-

上傳氣瓶出入庫(kù)記錄upYhqpStoragelnfo-

上傳氣瓶移動(dòng)軌跡記錄upYhqpGPSInfo

上傳氣瓶充裝前后檢查記錄upYhqpFi]lingCheckInfo-

上傳氣瓶充裝記錄upYhqpFi11inglnfo-

車(chē)用氣瓶管獲取車(chē)用氣瓶車(chē)輛信息getCyqpCarlnfo車(chē)輛車(chē)牌號(hào)、車(chē)輛類(lèi)型、登記證信息

理獲取車(chē)用氣瓶明細(xì)信息gptCyqpInfn車(chē)輛氣瓶編號(hào)、制造單位、下次檢驗(yàn)

日期、標(biāo)簽類(lèi)型、標(biāo)簽號(hào)等

獲取車(chē)用氣瓶檢驗(yàn)記錄getCyqpChecklnfo車(chē)輛定檢記錄

獲取車(chē)用氣瓶黑名單信息getCyqpBlackList車(chē)輛黑名單記錄

上傳車(chē)用氣瓶登記信息upCyqpRegisterlnfo-

上傳車(chē)用氣瓶充裝前后檢查記錄upCyqpFi11ingChecklnfo-

上傳車(chē)用氣瓶充裝記錄upCyqpFi11inglnfo-

工業(yè)氣瓶管獲取氣瓶檔案數(shù)據(jù)getgyqpList-

理獲取氣瓶檢驗(yàn)記錄getgyqpChecklnfo-

獲取氣瓶充裝前后檢查記錄getgyqpFillingChecklnfo-

獲取氣瓶充裝記錄getgyqpFi11inglnfo-

獲取報(bào)廢氣瓶信息getgyqpScrapInfo-

上傳氣瓶檔案數(shù)據(jù)upgyqpList-

上傳氣瓶檢驗(yàn)記錄upgyqpChecklnfo-

上傳氣瓶出入庫(kù)記錄upgyqpStorageInfo-

上傳氣瓶移動(dòng)軌跡記錄upgyqpGPSInfo-

上傳氣瓶充裝前后檢查記錄upgyqpFillingCheckInfo

上傳氣瓶充裝記錄upgyqpFi11inglnfo-

10接口協(xié)議內(nèi)容

10.1通用應(yīng)用

10.1.1獲取授權(quán)碼接口

10.1.11功能說(shuō)明

本接口用于獲取服務(wù)方提供的接口授權(quán)碼。數(shù)據(jù)調(diào)用方通過(guò)HTTP的POST接口與服務(wù)

方通信。

10.1.12接口地址

http://〈服務(wù)器IP＞:＜服務(wù)器端口＞/＜系統(tǒng)簡(jiǎn)稱(chēng)＞/comm/getTicket

10.1.13人參

參數(shù)名類(lèi)型是否必選參數(shù)描述

userCodeString必選用戶識(shí)別碼

serviceCodeString必選服務(wù)編碼

示例：

（

data:{

userCodeJ用戶識(shí)別碼。

serviceCode:,Servicel,

）

）

10.1.14出參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataString必選臨時(shí)授權(quán)碼

rtString必選狀態(tài)對(duì)象

狀態(tài)對(duì)象

參數(shù)名類(lèi)型是否必選參數(shù)描述

fromSystemString必選數(shù)據(jù)來(lái)源系統(tǒng)

msgString必選狀態(tài)說(shuō)明

statusInteger必選狀態(tài)碼

返回報(bào)文格式：

（

“data”：，臨時(shí)授權(quán)碼

"rt":{

"fromSystem":"平臺(tái)名稱(chēng)"，

"msg":"操作成功”，

"status":200

）

）

10.1.2獲取數(shù)據(jù)字典

10.1.21功能說(shuō)明

本接口用于獲取服務(wù)方提供的數(shù)據(jù)字典信息，如氣瓶充裝介質(zhì)、標(biāo)簽類(lèi)型、氣瓶種類(lèi)、

氣瓶型號(hào)、氣瓶品種等。數(shù)據(jù)調(diào)用方通過(guò)HTTPPOST接口與服務(wù)方接I」通信。

10.1.22接口地址

http:〃〈服務(wù)器IP>:(服務(wù)器端口>/<系統(tǒng)簡(jiǎn)稱(chēng)>/comm/getDict?authorization=<gR55>

10.1.23人參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataJson必選搜索對(duì)象

搜索對(duì)象

參數(shù)名類(lèi)型是否必選參數(shù)描述

typeString必選字典類(lèi)型，傳入不同的type值獲取不

同的數(shù)據(jù)字典，充裝介質(zhì)：

YHQP_MEDIUM、標(biāo)簽類(lèi)型：

QP_TAG_TYPE、氣瓶種類(lèi)：

EQUCLASS_YHQP、氣瓶型號(hào)：

EQUMODEL_YHQP、氣瓶品種：

EQUTYPE_YHQP

示例：

(

data:{

type:'YHQP_MEDIUM'

)

)

10.1.24出參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataString必選分頁(yè)對(duì)象

rtString必選狀態(tài)對(duì)象

字典類(lèi)型

名稱(chēng)類(lèi)型必埠？說(shuō)明備注

idStringY編號(hào)

labelStringY標(biāo)簽名

valueStringY數(shù)據(jù)值

typeStringY類(lèi)型

descriptionStringY描述

sortIntegerY排序（升序）

parentValueStringY

createByStringY創(chuàng)建者

createDateDateY創(chuàng)建時(shí)間

updateByStringY更新者

updateDateDateY更新時(shí)間

remarksStringY備注信息

delFlagStringY刪除標(biāo)記

返回報(bào)文格式：

(

"data":{

"count":3,

"page":1,

"pageSize":10,

"total":1,

"rows":[

(

"createBy":null,

ncreateDate":"2020-03-1910:01:01”,

"delFlag":"0'\

“description":"液化石油氣瓶充裝介質(zhì)”，

,,

"id"："94733412f3a611e8bce530el71537f8d/

"label":"LPG”，

"parentvalue":null,

"remarks**:null,

“sort"：1,

n

"type":YHQP_MEDIUM"z

"updateBy”:null,

nupdateDate":null,

"value":"1"

},

(

"createBy":null,

"createDate":"2020-03-2621:24:03”，

“delFlag"：“0"，

1,description":"液化石油氣瓶充裝介質(zhì)”，

"id"："94733412f3a6112cbce530el71537f8d'\

?,label":“丙烷”，

'?parentvalue":null,

“remarks”:null,

"sort*':2,

,,,,

"type":YHQP_MEDIUM,

"updateBy":null,

nupdateDate":null,

“value“："2“

)

],

},

"rt":{

"fromSystem":"平臺(tái)名稱(chēng)"，

"msg":”操作成功”，

"status":200

)

)

10.1.3獲取制造單位信息

10.1.31功能說(shuō)明

本接口用于獲取液化氣瓶、工業(yè)氣瓶、車(chē)用氣瓶的制造單位信息。數(shù)據(jù)調(diào)用方通過(guò)HTTP

POST接口與上級(jí)氣瓶質(zhì)量安全追溯信息平臺(tái)接口通信。

10.1.32接口地址

http:〃〈服務(wù)器IP>:(服務(wù)器端口>/<系統(tǒng)簡(jiǎn)稱(chēng)》/comm/getProduceUnit?authorization=<

授權(quán)碼〉

10.1.33人參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataJson必選搜索對(duì)象

搜索對(duì)象

參數(shù)名類(lèi)型是否必選參數(shù)描述

produceUnitString必選制造單位名稱(chēng)

示例:

data:{

'?produceunit":"江蘇華天能源裝備有限公司”

}

)

10.1.34出參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataString必選分頁(yè)對(duì)象

rtString必選狀態(tài)對(duì)象

制造單位對(duì)象

名稱(chēng)類(lèi)型必填？說(shuō)明備注

produceUnitIdIntegerY系統(tǒng)ID

produceUnitStringY制造單位名稱(chēng)

produceUnitSimpleStringY制造單位簡(jiǎn)稱(chēng)

licenseNoStringY制造單位代號(hào)TS2210K25

licenseNoYearStringY許可證編號(hào)(帝年TS2210K25-2016

份)

produceUnitCodeStringY單位代碼

remarksStringY備注

deleteFlagStringY刪除標(biāo)志，0-未刪

除，1-刪除

createTimeDateY數(shù)據(jù)創(chuàng)建時(shí)間

lastUpdateTimeDateY最新更新時(shí)間，時(shí)

間戳

返回報(bào)文格式：

{

"data":{

"count1,:3,

page:1,

"pageSize":10,

"total":1,

"rows":[

(

"cd"：null,

"createDate":null,

"createTime":'12020-04-0319:35:48”，

"delFlag":null,

"deleteFlag":"0",

"endDate":null,

"id"：null,

"lastUpdateTime":"2020-04-0319:35:48.0”,

"lastdateprocetype":null,

"licenseNo":"TS2210K25”，

"nameOrCode":null,

"orderByH:null,

"pageNum":1,

"pageSize**:10,

“produceunit”：“江蘇華天能源裝備有限公司“，

"produceUnitCode";"HTZ",

"produceUnitIdn:1,

'?produceUnitSimple1*:“華天能源”，

"remarksM:"

"startDate":null,

"uuid":null

)

L

},

"rt":{

"fromSystem":"平臺(tái)名稱(chēng)"，

"msg":"操作成功"，

"status":200

)

)

10.1.4獲取單位信息

10.1.41功能說(shuō)明

本接口用于獲取液化氣瓶、工業(yè)氣瓶、車(chē)用氣瓶充裝單位、檢驗(yàn)單位信息。數(shù)據(jù)服務(wù)商

通過(guò)HTTPPOST接口與各氣瓶質(zhì)量安全追溯信息平臺(tái)接口通信。

10.1.42接口地址

http:〃〈服務(wù)器IP＞:《服務(wù)器端口＞/〈系統(tǒng)簡(jiǎn)稱(chēng)＞/comm/getUnit?authorization=＜授權(quán)碼＞

10.1.43人參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataJson必選搜索對(duì)象

搜索對(duì)象

參數(shù)名類(lèi)型是否必選參數(shù)描述

unitNatureString必選單位性質(zhì)unitNature傳入不同值獲取

不同的單位列表，液化氣瓶充裝單

位：cl、工業(yè)氣瓶充裝單位：c3、車(chē)

用氣瓶充裝單位：c2；液化氣瓶檢驗(yàn)

機(jī)構(gòu)：jl、工業(yè)氣瓶檢驗(yàn)機(jī)構(gòu)：j3、車(chē)

用氣瓶檢驗(yàn)機(jī)構(gòu)：j2

示例:

data:{

unitNature：'cl'

)

)

10.1.44出參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataString必選分頁(yè)對(duì)象

rtString必選狀態(tài)對(duì)象

單位對(duì)象

名稱(chēng)類(lèi)型必填？說(shuō)明備注

unitldIntegerY系統(tǒng)ID

unitOrgCodeStringY單位機(jī)構(gòu)序列編

碼

unitOrgldSeqStringY單位機(jī)構(gòu)序列

id

unitNaroeStringY單位名稱(chēng)

unitSimpleNameStringY單位簡(jiǎn)稱(chēng)

propertyUnitSocialCodeStringY統(tǒng)一社會(huì)信用代

碼

unitPhoneStringY單位聯(lián)系電話

unitLegalStaffStringY法定代表人

unitLegalPhoneStringY聯(lián)系人聯(lián)系電話

unitContactStaffStringY單位聯(lián)系人

certNoStringY充裝單位使用登

記證號(hào)

unitLocationStringY單位地址

IngLatStringY

longitudeDoubleY”度

latitudeDoubleY緯度

unitStatusStringY單位狀態(tài)

unitNatureStringY單位性質(zhì)

createldStringY創(chuàng)建記錄的賬號(hào)

ID

orgCodeStringY數(shù)據(jù)所屬機(jī)構(gòu)序

列編碼

orgldSeqStringY數(shù)據(jù)所屬機(jī)構(gòu)序

列id

createTimeDateY數(shù)據(jù)創(chuàng)建時(shí)間

deleteFlagStringY刪除標(biāo)志，0-未

刪除，1-刪除

updateldStringY修改記錄的賬號(hào)

ID

lastUpdateTimeDaleY最新更新時(shí)間，

時(shí)間戳

dataFromStringY數(shù)據(jù)來(lái)源，0-PC

端批量導(dǎo)入，1-

PC端人工錄入，

2-移動(dòng)端人工錄

入，3-系統(tǒng)接口

返回報(bào)文格式:

"data":{

"count":3,

"page":1,

"pageSize":10,

"total":1,

"rows":[

cd":null.

?,uerLNu":null,

,'createDate":null,

H

“createld"："wgx

ncreateTimen:"2020-04-2300:00:00”，

"dataFrom"："2"，

'?delFlag":null,

??deleteFlag'1:“0"，

"endDate":null,

"filelds":null,

'?files*1:null,

"id":null,

"IngLat":"118.332971,31.341414H,

"lastUpdateTimen:"2020-05-0510:51:56.0'\

"lastdateprocetype":null,

"latitude?1:31.385422,

"longitude":118.303755,

"num":null,

"orderBy":null,

,,,

??orgCode":340000u45'/

??orgldSeq11:"0.1.u45.H,

?'pageNum":1,

"pagesize”:10,

??propertyUnitSocialCode":"674853475637P?,

??quallds":null,

"quals":null,

nstartDateH:null,

"unitContactStaff":"李四"，

"unitld":45,

nH,,,

unitLegalPhone,

"unitLegalStaff1:"張三”，

??unitLocation":"安徽省蕪湖市鳩江區(qū)G5011（二壩樞紐）”,

"unitName":"測(cè)試檢驗(yàn)機(jī)構(gòu)1”,

"unitNature11:'*j4,j5,j6",

,,,,

"unitOrgCode":340000u45,

"unitOrgldSeq":,,0.1.u45.'\

??unitPhone11:,

'?unitSimpleName**:"CSJYI",

“unitstatus":“0”,

"updateId"："wg",

Huuidn:null

|

】，

},

"rt":{

吁romSystem":"平臺(tái)名稱(chēng)”,

"msg":"操作成功",

"status":200

10.1.5獲取作業(yè)人員信息

10.1.51功能說(shuō)明

本接口用于獲取氣瓶充裝人員、安全管理人員及檢驗(yàn)人員的信息。數(shù)據(jù)服務(wù)商通過(guò)HTTP

POST接口與各氣瓶質(zhì)量安全追溯唁息平臺(tái)接口通信。

10.1.52接口地址

http:〃（服務(wù)器IP＞:＜服務(wù)器端口＞/＜系統(tǒng)簡(jiǎn)稱(chēng)＞/comm/getOperators?authorization=＜K

權(quán)碼〉

10.1.53入?yún)?/p>

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataJson必選搜索對(duì)象

搜索對(duì)象

參數(shù)名類(lèi)型是否必選參數(shù)描述

stationNameString非必選崗位名稱(chēng)stctionName傳入不同值獲

取不同崗位的人員列表，法人：m,

站長(zhǎng)（站點(diǎn)負(fù)責(zé)人）：m2,充裝檢查

人員：m3,充裝人員：m4,檢驗(yàn)人員：

m5,其他人員：m6

示例：

(

data:{

stationName/mr

)

)

10.1.54出參

參數(shù)名類(lèi)型是否必選參數(shù)描述

dataString必選分頁(yè)對(duì)象

rtString必選狀態(tài)對(duì)象

人員對(duì)象

名稱(chēng)類(lèi)型必填？說(shuō)明備注

staffldIntegerY系統(tǒng)ID

photoPathStringY照片位置

staffNameStringY人員姓名

idCardNoStringY身份證號(hào)

ageIntegerY年齡

genderStringY性別

phoncNumbcrStringY手機(jī)電話號(hào)碼

jobNumberStringY工號(hào)

unitBelongToStringY所屬單位

propertyllnitSocia1CodStringY所屬單位統(tǒng)一社

e會(huì)信用代碼

stationNameStringY崗位名稱(chēng)

onStationStatusStringY在職狀態(tài)

checklnDateDateY入職時(shí)間

work