MHT 1076.2-2023 民航旅客行李全流程跟踪系统 第2部分：数据交换接口规范

ICS03.220.50CCSV56MH中华人民共和国民用航空行业标准MH/T1076.2—2023民航旅客行李全流程跟踪系统第2部分：数据交换接口规范Civilaviationpassengerbaggagetrackingsystem—Part2:Specificationofdataexchangeinterface2023-02-06发布2023-03-01实施中国民用航空局发布MH/T1076.2—2023I目次前言.................................................................................II引言................................................................................III1范围................................................................................12规范性引用文件......................................................................13术语和定义..........................................................................14缩略语..............................................................................15网络连接方式........................................................................16访问控制............................................................................17交换的数据报文.......................................................................28交换协议.............................................................................29交换流程.............................................................................29.1向公共信息平台发送数据流程.......................................................29.2从公共信息平台获取数据流程......................................................210交换接口............................................................................310.1通用说明........................................................................310.2登录验证接口...................................................................410.3BPM数据上报接口...............................................................510.4BPM数据下发接口...............................................................510.5BSM数据下发接口...............................................................7参考文献..............................................................................9MHMH/T1076.2—2023II前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是MH/T1076《民航旅客行李全流程跟踪系统》的第2部分。MH/T1076已经发布了以下部分：——第1部分：机场端建设规范；——第2部分：数据交换接口规范；——第3部分：报文规范。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国民用航空局运输司提出。本文件由中国民航科学技术研究院归口。本文件起草单位：中国民航信息网络股份有限公司、中国民用航空局运输司、中国民用航空局信息中心、上海民航华东凯亚系统集成有限公司、中国民航大学、中国南方航空股份有限公司。本文件主要起草人：王卫军、智慧、耿思、刘毅、于辉、胡冰、刘王君、王晓杰、唐婷、潘乃槟、王翔宇、董云杉、张丽丽、王道明、黄小东、洪泽琳、毛丹、马晓宁、胡泽、邢伟、李宪武、郑兴、姚㛃。MH/T1076.2—2023III引言近年来，中国民航加快落实新时代民航强国建设与高质量发展等有关要求，以智慧民航建设为主线，开展“行李全流程跟踪系统建设”专项行动，大力推动民航旅客托运行李运输的信息化、智能化、多样化发展，全面提升行李服务的水平，着力解决旅客航空出行痛点，使旅客安心出行。2020年12月，民航局面向全行业印发了《全民航行李全流程跟踪系统建设实施方案》，明确提出按照“一标两端”的思路推进行李全流程跟踪系统建设。“机场端”主要负责采集、处理和传输机场内旅客托运行李相关环节的数据，以标准格式和固定制式向平台端上传行李数据，并从平台端获取行李跟踪信息，实现行李查询、预警、不正常行李管理等功能。“平台端”主要负责汇集行李全流程跟踪信息，实现数据共享，向机场、航空公司等提供相关行李数据，为政府实施监督管理提供支持。平台端分为行李公共信息平台和行李监管平台。MH/T1076旨在为机场、航空公司提供行李全流程跟踪服务涉及的系统建设、接口与设备，以及信息写入与读取、传输与共享等相关规范标准，包括以下4个内容。——第1部分：机场端建设规范。目的在于确立行李全流程跟踪系统机场端的建设及技术要求。——第2部分：数据交换接口规范。目的在于为保证行李全流程跟踪系统中不同系统，与中国民航行李全流程跟踪系统公共信息平台方（简称公共信息平台）间的数据交换（包括数据采集）确立数据交换接口的数据格式、调用方式等技术要求。——第3部分：报文规范。目的在于为保证行李全流程跟踪系统中不同系统，与公共信息平台间报文的有效传输确立各类报文格式的编写规范。——第4部分：RFID存取技术规范。目的在于明确民用航空托运行李信息跟踪的RFID标签类型、编码规则、读取规范、应用及安全等技术要求。本次对MH/T1076.2的制定，使机场、航空公司等单位的行李全流程跟踪接口有据可依，更好地促进全行业行李运输的发展。MHMH/T1076.2—20231民航旅客行李全流程跟踪系统第2部分：数据交换接口规范1范围本文件规定了民航旅客行李全流程跟踪系统数据交换接口的基本要求。本文件适用于民航机场、航空公司、中国民航行李全流程跟踪系统监管平台（简称监管平台）、其他相关方的行李相关信息系统与公共信息平台进行旅客行李数据的采集与交换。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。MH/T1076.3—2023民航旅客行李全流程跟踪系统第3部分：报文规范3术语和定义下列术语和定义适用于本文件。3.1行李源报文baggagesourcemessage由离港控制或值机系统发送的包含航班信息、旅客信息、行李基本信息等数据项的标准格式报文。3.2行李处理报文baggageprocessedmessage由行李处理系统或行李再确认系统发送的包含航班信息、旅客信息、行李基本信息、行李操作记录等数据项的标准格式报文。4缩略语下列缩略语适用于本文件。ACK：确认字符（Acknowledgecharacter）API：应用程序接口（ApplicationProgrammingInterface）BPM：行李处理报文（baggageprocessedmessage）BSM：行李源报文（baggagesourcemessage）HTTP：超文本传输协议（HyperTextTransferProtocol）HTTPS：安全超文本传输协议（HypertextTransferProtocolSecure）IP：网际互连协议（InternetProtocol）URL：统一资源定位系统（UniformResourceLocator）uuid：通用唯一识别码（UniversallyUniqueIdentifier）5网络连接方式民航机场、航空公司、监管平台方、其他相关方的行李相关信息系统应通过专网直连公共信息平台。6访问控制公共信息平台管理方应采用如下两种形式进行访问控制：MHMH/T1076.2—20232——网络访问控制：公共信息平台管理方基于IP地址进行网络访问策略授权，经过授权的IP地址方可访问公共信息平台；——权限访问控制：公共信息平台管理方为民航机场、航空公司、监管平台方、其他相关方分配公共信息平台的访问账号和口令，基于权限可访问公共信息平台。7交换的数据报文基于公共信息平台交换的数据报文应包括以下两种：——民航机场、航空公司、监管平台方、其他相关方等从公共信息平台获取的BSM；——民航机场、航空公司、监管平台方、其他相关方等向公共信息平台发送和从公共信息平台接收的BPM。BPM的格式应符合MH/T1076.3—2023规定的报文格式要求。8交换协议民航机场、航空公司、监管平台方、其他相关方等应通过访问公共信息平台管理方提供的HTTPS协议API实现数据的交换。公共信息平台管理方应提供四类API服务：——公共信息平台登录验证；——获取BSM；——上传BPM；——获取BPM。注：每种API的详细定义及调用方式见第10章。9交换流程9.1向公共信息平台发送数据流程民航机场、航空公司、监管平台方、其他相关方等单位应按照图1流程向公共信息平台发送数据。图1向公共信息平台发送数据流程9.2从公共信息平台获取数据流程民航机场、航空公司、监管平台方、其他相关方等单位应按照图2流程从公共信息平台获取数据。MH/T1076.2—20233图2从公共信息平台获取数据流程10交换接口10.1通用说明10.1.1数据格式接口返回的数据应采用JSON格式封装。10.1.2调用方式数据调用方式应基于HTTPS协议，采用POST或GET方式传递。宜根据调用者需要按接口要求设置Content-type。10.1.3系统约定除特别说明，上传、下发数据均应使用UTF-8编码。数据均应为大小写敏感，包括：航班号、时间、航站三字码等。10.1.4返回结果状态码说明返回结果状态码code说明如下：——000成功；——001用户名或密码错误；——002未登录或无效token；——003参数不能为空；——004非法数据；——005处理失败；注：处理失败指的是公共信息平台在处理调用者参数过程中，出现不可预见性错误。——006数据为空。注：数据为空指的是公共信息平台在处理过程时，没有找到或公共信息平台端不存在需要下发的数据。MHMH/T1076.2—2023410.2登录验证接口10.2.1场景调用者调用公共信息平台接口，提交公共信息平台分配访问账号、密码，通过返回的调用结果JSON字符串，取得令牌(token)。当调