T∕CATAGS 82-2024 民航重大运输保障任务旅客行李信息交互规范

CATAGSSpecificationofPassengerBaggageInformationInteractionforMajorCivilAviation2024-11-5发布I 2 2 3 3 3 3 3 3 3 4 4 4 5 5 5 8 9本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。琳、毛丹、刘王君、胡冰、黄泽滨、陈艳江、1民航重大运输保障任务旅客行李信息交互规范本文件规定了民航重大运输保障任务中各参与方系统需要与中国民航行李全流程跟踪系统公共信本文件适用于民航重大运输保障任务中参与旅客行李运输保障的机场、航空公司及其他相关单位。4缩略语BTS：中国民航行李全流程跟踪系统公共信息平台（BaggageTrackingSystem）在民航重大运输保障任务中，当参与保障的相关业务单位需要获取重大运输保障中旅客的行李信息时，则应向BTS进行所需旅客行李数据订阅，并通过交互接口获取民航重大运输保障任务中相关保障单位的业务系统应按如下流2民航重大运输保障任务中的相关各保障单位业务系统与BTS进1Y2N3O民航重大运输保障任务中的相关保障单位可通过8.7的旅客行李数据订阅接口向BTS订阅指定旅客1taskCodeY2Y3Y4passengerStatusY5Y姓6Y名7N8N9boardNoOBTS根据民航重大运输保障任务中的相关保障单位的旅客行李信息订阅需求，基于旅客姓名及登记序号进行匹配，查找相关保障单位订阅旅客对应的行李信息，并通过8.7订阅旅客的行李数据推送接口1taskCodeYboardNoO3Y姓4Y名5N6Y7Y8bagStatusY39bagQtyNwgtUnitNbagWgtNNbagNumberY民航重大运输保障任务中相关保障单位的业务系统与BTS通过BTS订阅旅客数据的接口与BTS向相关保障单位业务系统推送订阅旅客的行李数据接口。民航重大运输保障任务中各参与方系统与BTS进行旅客行李信息交互传输时应采用HTTPS协议，数据发送采用POST方式。一般在POST方法BODY中，上传json格式或文本/字符串参数。为了支持调用者需要在HTTPSHeader参变量Content-type设定为application/——Content-Type：标准字段，调用方发送的数据类型，如application/——X-trust-nonce：随机数，调用方需在每次请求时，使用不同的随机数，用于防重放，如——Method：请求方法，请求时携带，如G——200请求成功——400BadRequest(请求出现语法错误)，如参数不合法——401Unauthorized(访问被拒绝，客户试图未经授权访问受密码保护的资源)——403Forbidden(资源不可用，服务器正确解析客户的请求，但拒绝处理它)——404NotFound(无法找到指定位置的资源)4——406NotAcceptable(指定的资源已经找到，但资源的类型和请求的类型不兼容)——409Conflict（指定的资源版本不匹配，或者资源重复，服务器拒绝创建）——其它在接口的返回中进行说明参与民航重大运输保障任务的相关保障单位通过该接口，向BTS发送需订阅行李数据的旅客信息，每次订阅的旅客信息为一组旅客列表，列表中的每个旅客信息数据项包含的字段应符合表2的要求，一——接口名称：旅客行李数据订阅接口；——Content-type：application/json;charset=UTF-8；——调用方式：POST；——请求参数：见表4；YX-trust-signature-versionYX-trust-appidYYX-trust-nonceYX-trust-signatureYYYNPOST/**/**/btMessageSubs"X-trust-signature-ver"X-trust-timestamp":"1"Content-Type":application/json{5}HTTPS/1.1200OKContent-Type:applicati{}Content-Type:applicati{}BTS通过该接口，向参与民航重大运输保障任务的相关保障单位推送其订阅旅客的行李数据。每次——接口名称：获取订阅旅客的行李数据接口；——Content-type：application/json;charset=UTF-8；——调用方式：POST；——请求参数：见表6；6YX-trust-signature-versionYX-trust-appidYYX-trust-nonceYX-trust-signatureYYYYYbaggagesYPOST/**/**/btMessagePub"X-trust-signature-ver"X-trust-timestamp":"1"Content-Type":application/json{"bagbagStatus":"add","bagStatus":"del",7"dimension":"45*120}HTTPS/1.1200OKContent-Type:applicati{}Content-Type:applicati{}8调用方发起请求时，需携带签名信息，服务器验证签名失败时，返回HTTP4签名信息由HTTP协议Header中的X-trust-signature字段表示，而不是放在HTTP的Header字段签名采用HMAC-SHA-1算法进行计算，具Signature=HMAC-SHA-1HMAC-SHA-1输出的原始结果为20字节二进制数据，在实际传输时，转换9 ——Content-Type：标准字段，调用方发送的数据类型，如application/j——X-trust-appid：值为服务器分配的appid，如4——X-trust-timestamp：值为时间戳，如158——X-trust-nonce：随机数，调用方需在每次请求时，使用不同的随机数，用于防重放，如1917b36f0a7f732f0ca0da0651d498e7（如果请求Body为空，比如GET请求，则32位的MD5值应为d41d8cd98f00b204e98009——Method：请求方法，请求时携带，如GET或P——content-type=application——x-trust-signature-version——x-trust-timestamp=15816——x-trust-nonce=af0ifj——content-md5-hex=1917b36f0a7f732f0ca0da0651d对这7个字符串，按字符串排序并使用&符