MH-T 1076.2-2023 民航旅客行李全流程跟蹤系統(tǒng) 第2部分：數(shù)據(jù)交換接口規(guī)范

ICS

03.220.50CCS

V

56MH中華人民共和國民用航空行業(yè)標(biāo)準(zhǔn)MH/T

—2023民航旅客行李全流程跟蹤系統(tǒng)第

2

部分：數(shù)據(jù)交換接口規(guī)范Civil

passenger

baggage

tracking

system—Part

2:

of

data

exchange

2023-02-06

發(fā)布 2023-03-01

實施中國民用航空局 發(fā)

布MH/T

—2023 前言

.................................................................................

II引言

................................................................................

III1

范圍

................................................................................

12

規(guī)范性引用文件

......................................................................

13

術(shù)語和定義

..........................................................................

14

縮略語

..............................................................................

15

網(wǎng)絡(luò)連接方式

........................................................................

16

訪問控制

............................................................................

17

交換的數(shù)據(jù)報文.......................................................................

28

交換協(xié)議.............................................................................

29

交換流程.............................................................................

29.1

向公共信息平臺發(fā)送數(shù)據(jù)流程

.......................................................

29.2

從公共信息平臺獲取數(shù)據(jù)流程

......................................................

210

交換接口............................................................................

310.1

通用說明........................................................................

310.2

登錄驗證接口

...................................................................

410.3

BPM

數(shù)據(jù)上報接口...............................................................

510.4

BPM

數(shù)據(jù)下發(fā)接口...............................................................

510.5

BSM

數(shù)據(jù)下發(fā)接口...............................................................

7參考文獻(xiàn)

..............................................................................

9MH/T

—2023 本文件按照GB/T

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

10762部分。MH/T

1076已經(jīng)發(fā)布了以下部分：——第

1

部分：機(jī)場端建設(shè)規(guī)范；——第

2

部分：數(shù)據(jù)交換接口規(guī)范；——第

3

部分：報文規(guī)范。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由中國民用航空局運(yùn)輸司提出。本文件由中國民航科學(xué)技術(shù)研究院歸口。中心、上海民航華東凱亞系統(tǒng)集成有限公司、中國民航大學(xué)、中國南方航空股份有限公司。本文件主要起草人：王衛(wèi)軍、智慧、耿思、劉毅、于輝、胡冰、劉王君、王曉杰、唐婷、潘乃檳、?。IIMH/T

—2023 化發(fā)展，全面提升行李服務(wù)的水平，著力解決旅客航空出行痛點，使旅客安心出行。2020年12信息，實現(xiàn)行李查詢、預(yù)警、不正常行李管理等功能?！捌脚_端”主要負(fù)責(zé)匯集行李全流程跟蹤信息，李公共信息平臺和行李監(jiān)管平臺。MH/T

1076旨在為機(jī)場、航空公司提供行李全流程跟蹤服務(wù)涉及的系統(tǒng)建設(shè)、接口與設(shè)備，以及信息寫入與讀取、傳輸與共享等相關(guān)規(guī)范標(biāo)準(zhǔn)，包括以下4個內(nèi)容?！?/p>

1

部分：機(jī)場端建設(shè)規(guī)范。目的在于確立行李全流程跟蹤系統(tǒng)機(jī)場端的建設(shè)及技術(shù)要求?！?/p>

2

部分：數(shù)據(jù)交換接口規(guī)范。目的在于為保證行李全流程跟蹤系統(tǒng)中不同系統(tǒng)，與中國民航行李全流程跟蹤系統(tǒng)公共信息平臺方（簡稱公共信息平臺）間的數(shù)據(jù)交換（包括數(shù)據(jù)采集）確立數(shù)據(jù)交換接口的數(shù)據(jù)格式、調(diào)用方式等技術(shù)要求?！?/p>

3

部分：報文規(guī)范。目的在于為保證行李全流程跟蹤系統(tǒng)中不同系統(tǒng)，與公共信息平臺間報文的有效傳輸確立各類報文格式的編寫規(guī)范?！?/p>

4

部分：RFID

存取技術(shù)規(guī)范。目的在于明確民用航空托運(yùn)行李信息跟蹤的

RFID

標(biāo)簽類型、編碼規(guī)則、讀取規(guī)范、應(yīng)用及安全等技術(shù)要求。本次對MH/T

1076.2的制定，使機(jī)場、航空公司等單位的行李全流程跟蹤接口有據(jù)可依，更好地促進(jìn)全行業(yè)行李運(yùn)輸?shù)陌l(fā)展。IIIMH/T

—2023

1范圍本文件規(guī)定了民航旅客行李全流程跟蹤系統(tǒng)數(shù)據(jù)交換接口的基本要求。他相關(guān)方的行李相關(guān)信息系統(tǒng)與公共信息平臺進(jìn)行旅客行李數(shù)據(jù)的采集與交換。2 規(guī)范性引用文件文件。MH/T

1076.3— 民航旅客行李全流程跟蹤系統(tǒng)第3部分：報文規(guī)范3 術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1行李源報文

source

message由離港控制或值機(jī)系統(tǒng)發(fā)送的包含航班信息、旅客信息、行李基本信息等數(shù)據(jù)項的標(biāo)準(zhǔn)格式報文。3.2行李處理報文 baggage

processed

message等數(shù)據(jù)項的標(biāo)準(zhǔn)格式報文。4 縮略語下列縮略語適用于本文件。ACK：確認(rèn)字符（Acknowledge

character）API：應(yīng)用程序接口（

Programming

）BPM：行李處理報文（

）BSM：行李源報文（

source

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

Text

Transfer

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

Transfer

Protocol

Secure）IP：網(wǎng)際互連協(xié)議（

Protocol）URL：統(tǒng)一資源定位系統(tǒng)（Uniform

Resource

）uuid：通用唯一識別碼（

Unique

）5 網(wǎng)絡(luò)連接方式6 訪問控制公共信息平臺管理方應(yīng)采用如下兩種形式進(jìn)行訪問控制：MH/T

—2023——網(wǎng)絡(luò)訪問控制：公共信息平臺管理方基于

IP

地址進(jìn)行網(wǎng)絡(luò)訪問策略授權(quán)，經(jīng)過授權(quán)的

IP

地址方可訪問公共信息平臺；——權(quán)限訪問控制：公共信息平臺管理方為民航機(jī)場、航空公司、監(jiān)管平臺方、其他相關(guān)方分配公共信息平臺的訪問賬號和口令，基于權(quán)限可訪問公共信息平臺。7 交換的數(shù)據(jù)報文基于公共信息平臺交換的數(shù)據(jù)報文應(yīng)包括以下兩種：——民航機(jī)場、航空公司、監(jiān)管平臺方、其他相關(guān)方等從公共信息平臺獲取的

BSM；——民航機(jī)場、航空公司、監(jiān)管平臺方、其他相關(guān)方等向公共信息平臺發(fā)送和從公共信息平臺接收的

BPM。BPM的格式應(yīng)符合

1076.3—2023規(guī)定的報文格式要求。8 交換協(xié)議HTTPS協(xié)議API實現(xiàn)數(shù)據(jù)的交換。公共信息平臺管理方應(yīng)提供四類API服務(wù)：——公共信息平臺登錄驗證；——獲取

BSM；——上傳

BPM；——獲取

BPM。109 交換流程9.1 向公共信息平臺發(fā)送數(shù)據(jù)流程民航機(jī)場、航空公司、監(jiān)管平臺方、其他相關(guān)方等單位應(yīng)按照圖1流程向公共信息平臺發(fā)送數(shù)據(jù)。圖1 向公共信息平臺發(fā)送數(shù)據(jù)流程9.2 從公共信息平臺獲取數(shù)據(jù)流程民航機(jī)場、航空公司、監(jiān)管平臺方、其他相關(guān)方等單位應(yīng)按照圖2流程從公共信息平臺獲取數(shù)據(jù)。MH/T

—2023圖2 從公共信息平臺獲取數(shù)據(jù)流程10交換接口10.1 通用說明10.1.1 數(shù)據(jù)格式接口返回的數(shù)據(jù)應(yīng)采用格式封裝。10.1.2 調(diào)用方式數(shù)據(jù)調(diào)用方式應(yīng)基于協(xié)議，采用或GET方式傳遞。宜根據(jù)調(diào)用者需要按接口要求設(shè)置Content-type。10.1.3 系統(tǒng)約定除特別說明，上傳、下發(fā)數(shù)據(jù)均應(yīng)使用UTF-8數(shù)據(jù)均應(yīng)為大小寫敏感，包括：航班號、時間、航站三字碼等。10.1.4 返回結(jié)果狀態(tài)碼說明返回結(jié)果狀態(tài)碼code說明如下：——000

成功；——001

用戶名或密碼錯誤；——002

未登錄或無效

；——003

參數(shù)不能為空；——004

非法數(shù)據(jù)；——005

處理失??；處理失敗指的是公共信息平臺在處理調(diào)用者參數(shù)過程中，出現(xiàn)不可預(yù)見性錯誤?！?06

數(shù)據(jù)為空。codeByteBytedataByte20Bytepassword60ByteMH/T

—202310.2登錄驗證接口10.2.1 場景字符串，取得令牌(token)。當(dāng)調(diào)用者未調(diào)用登錄接口，沒有獲取正確的token過期后，后續(xù)其它接口調(diào)用，按要求返回結(jié)果狀態(tài)碼（code）。token作為當(dāng)前調(diào)用者身份的唯一標(biāo)識。10.2.2 接口格式登錄驗證的接口格式應(yīng)包括以下五個部分：——接口地址：；——

header

Content-type：；——調(diào)用方式：POST；——請求參數(shù)：數(shù)據(jù)結(jié)構(gòu)見表

1；——返回值：數(shù)據(jù)結(jié)構(gòu)見表

2。表1登錄驗證接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)表2 接口返回值數(shù)據(jù)結(jié)構(gòu)表1登錄驗證接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)表2 接口返回值數(shù)據(jù)結(jié)構(gòu)POSThttpPost.setHeader("Content-type":"application/json")

//

Content-type

"username":"testuser",

POST

"code":

"msg":"","data":

"token":

"code":

"msg":"","data":

"code":

"msg":"

"data":

token32BytetokenBPM500ByteBPMMH/T

—202310.3 BPM

數(shù)據(jù)上報接口10.3.1 場景調(diào)用者調(diào)用登錄驗證接口，獲得正確的token后，可發(fā)起B(yǎng)PM數(shù)據(jù)上報調(diào)用，把當(dāng)前民航機(jī)場或航空公司等收集到的行李處理數(shù)據(jù)，上報到公共信息平臺。當(dāng)調(diào)用者BPM回結(jié)果狀態(tài)碼，檢查其接口調(diào)用方式、接口URL地址、傳遞的參數(shù)方式是否正確。10.3.2 接口格式BPM數(shù)據(jù)上報接口格式應(yīng)包括以下五個部分：——接口地址：https://xxxx/openApi/pushService/bpm/v1；——

header

Content-type：；——調(diào)用方式：POST；——請求參數(shù)：數(shù)據(jù)結(jié)構(gòu)見表

3；——返回值：數(shù)據(jù)結(jié)構(gòu)見表

2。表3 BPM

數(shù)據(jù)上報接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)表3 BPM

數(shù)據(jù)上報接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)POSThttpPost.setHeader("Content-type":"application/text")

Content-type

BPM

BPM.V/1LSZX.F/MU5762/14NOV/KMG.N/3781008593001"code":

"msg":"","data":

"code":

"msg":"","data":

10.4 BPM

數(shù)據(jù)下發(fā)接口10.4.1 獲取公共信息平臺

BPM

獲取公共信息平臺

BPM

數(shù)據(jù)場景調(diào)用者調(diào)用登錄驗證接口，獲得正確的BPMtokenBPMtoken32BytetokenMH/T

—2023根據(jù)BPM下發(fā)的uuidBPM數(shù)據(jù)時，對于沒有確認(rèn)的BPM，公共信息平臺會再次下發(fā)。BPM24

獲取公共信息平臺

BPM

數(shù)據(jù)接口獲取公共信息平臺BPM數(shù)據(jù)接口格式包括如下的四個部分：——接口地址：；——調(diào)用方式：GET；——請求參數(shù)：數(shù)據(jù)結(jié)構(gòu)見表

4；——返回值：數(shù)據(jù)結(jié)構(gòu)見表

2。表4 獲取公共信息平臺

數(shù)據(jù)接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)表4 獲取公共信息平臺

數(shù)據(jù)接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)

識用戶身份。無需額外傳遞任何參數(shù)。"code":

"msg":

","data":{

BPM.V/1LSZX.J/S/SZXPORT/117/14NOV/091430L/T1A117/S27H44/CK/SE.F/MU5762/14NOV

/KMG.N/3781008593001

","uuid":"b61515ca7e11415aa06348e093b8bac0"}//

字符串說明。BPM

data.uuid

BPM

"code":

"msg":

","data": 10.4.2BPM

消息主動應(yīng)答/

BPM

消息主動應(yīng)答/確認(rèn)場景調(diào)用方調(diào)用完成公共信息平臺的BPMBPMuuid/調(diào)用公共信息平臺BPM應(yīng)答接口，和公共信息平臺確認(rèn)該BPM BPM

消息主動應(yīng)答/

BPM消息主動應(yīng)答/ACK接口格式應(yīng)包括如下的五個部分?！涌诘刂罚篽ttps://xxxx/openApi/pullService/ack/bpm/v1?！?/p>

header

Content-type：x-www-form-urlencoded?！{(diào)用方式：POST?！埱髤?shù)：數(shù)據(jù)結(jié)構(gòu)見表

5?！祷刂担簲?shù)據(jù)結(jié)構(gòu)見表

2。token32Bytetokenuuid32Bytex-www-form-urlencodedMH/T

—2023表5BPM

消息主動應(yīng)答/確認(rèn)

表5BPM

消息主動應(yīng)答/確認(rèn)

接口請求參數(shù)數(shù)據(jù)結(jié)構(gòu)POSThttpPost.setHeader("Content-Type":"application/x-www-form-urlencoded");//

Content-type

new

formParams.add(new

));//

uuid

new

"UTF-8");httpPost.setEntity(encodeEntity);CloseableHttpResponse

httpclient.execute(httpPost);"code":

"msg":"","data":

"code":

"005","msg":"","data":

10.5 BSM

數(shù)據(jù)下發(fā)接口10.5.1 獲取公共信息平臺機(jī)場

BSM

數(shù)據(jù)接口 獲取公共信息平臺機(jī)場

BSM

數(shù)據(jù)場景調(diào)用者調(diào)用登錄驗證接口，獲得正確的后，發(fā)起B(yǎng)SM數(shù)據(jù)下發(fā)接口調(diào)用，獲取BSM。當(dāng)輸入?yún)?shù)中的token有效時，公共信息平臺可識別當(dāng)前用戶憑證，下發(fā)適合當(dāng)前調(diào)用者下發(fā)規(guī)則的BSMBSM下發(fā)中的BSMACK確認(rèn)的BSM發(fā)。BSM24

獲取公共信息平臺機(jī)場

BSM

數(shù)據(jù)接口獲取公共信息平臺機(jī)場BSM數(shù)據(jù)接口格式應(yīng)包括如下的四個部分：——接口地址：；——調(diào)用方式：GET；——請求參數(shù)：數(shù)據(jù)結(jié)構(gòu)見表

4；——返回值：數(shù)據(jù)結(jié)構(gòu)見表

2。

"code":

"msg":

","data":{

MH/T

—2023"BSM.V/1LSZX.N/3781122420001.S/Y/34L/C/017//Y.W/K/1/11.P/1HUANGFEIXIANGENDBSM","uuid":"b61515ca7e11415aa06348e093b8bac0"}}//

字符串說明。BSM

原始報文。

BSM

BSM

"code":

"msg":

","data":

10.5.2BSM

消息主動應(yīng)答/

BSM

消息主動應(yīng)答/

調(diào)用方調(diào)用完成公共信息平臺的BSMBSMuuid/調(diào)用公共信息平臺機(jī)場應(yīng)答接口，和公共信息平臺確認(rèn)該BSM已正確處理。BSM

消息主動應(yīng)答/

BSM消息主動應(yīng)答/ACK接口格式包括如下的五個部分：——接口地址：；——

header

Content-type：x-www-form-urlencoded；——調(diào)用方式：POST；——請求參數(shù)：數(shù)據(jù)結(jié)構(gòu)見表

5；——返回值：數(shù)據(jù)結(jié)構(gòu)見表

2。POSThttpPost.setHeader("token":"MANAGER69da327037304926825da9c236a5511c");httpPost.setHeader("Content-Type":"application/x-www-form-urlencoded");//

Content-type

new

formParams.add(new

));//

uuid

new

"UTF-8");httpPost.setEntity(encodeEntity);CloseableHttpResponse

httpclient.execute(http