# 机票乘机人信息查询

# 总体说明

接口采用 HTTP 协议，UTF-8 编码

header 添加参数（回调时需传回）：

swimlane="泳道信息xxx"，举例：swimlane=selftest-250709-110905-832
INF-CELL="灰度信息xxx"，举例：INF-CELL=gray-release-tmc-testing

注意

优先在订单下单 header 头中原样获取落库，后续相关回调都可用该参数按上述格式放入 header 头中返回
上述参数在 body 中也可获取，但 body 中取值字段为 swimlane 和 inf_cell，回调还按上述格式放入 header 头即可

# 接口说明

名称	描述
功能	根据订单号查询乘机人相关信息，用于春秋航司会员三要素认证
HTTP方法	POST
请求方	连铁平台（或其他航司相关方）
响应方	美团企业版平台
uri	/api/sqt/open/plane/supply/queryPassengerInfo
method	flight.passenger.info.query

# 加解密处理

所有请求体：

名称	类型	是否必填	示例	说明
partnerAccessKey	String	是	ETHRME7LOXDT-TK	美团企业版分配给供应商的接入密钥
content	String	是	UgxoCGPQIzoP	请求体内容，将请求参数JSON序列化后进行加密的结果值

# 业务参数

名称	类型	是否必填	示例	说明
ts	Long	是	1617085650321	13位时间戳。若请求发起时间与平台接受请求时间相差大于10分钟，平台将直接拒绝本次请求
partnerCode	Integer	是	1020002	美团给供应商分配的code，固定为1020002
bizOrderId	String	是	1614164690110001	美团企业版订单号，唯一标识一笔订单

# 业务响应

# 响应参数

名称	类型	是否必填	示例	说明
bookerInfo	Object	是	-	预订人信息
passengerList	List	是	-	乘机人信息列表

# Person 对象结构（预订人和乘机人共用）

名称	类型	是否必填	示例	说明
name	String	是	张三	姓名
phoneNumber	String	是	13800138000	手机号（完整号码）

# 响应说明

# 响应状态码

status	msg	说明
0	成功	查询成功，返回乘机人信息
1001	非TMC订单	该订单为非企业版订单，无法获取详细信息
1004	系统异常	系统内部异常，请稍后重试

# 业务场景说明

# 使用场景

春秋航司会员认证：连铁平台通过此接口获取企业版订单关联的乘机人信息，填充春秋航司会员三要素（姓名、手机号等）
出票前验证：在出票前验证乘机人信息的完整性和准确性
订单追踪：支持根据美团订单号快速查询对应的乘机人信息

# 业务流程

连铁平台
   |
   | 1. 调用此接口，传入 bizOrderId
   |
   v
美团企业版平台
   |
   | 2. 根据 bizOrderId 查询订单信息
   | 3. 提取订单中的乘机人信息
   | 4. 返回乘机人相关数据
   |
   v
连铁平台
   |
   | 5. 获取乘机人手机号和其他信息
   | 6. 调用春秋航司 API 进行会员认证和出票
   |
   v
春秋航空

# 示例

# 请求示例

# TMC订单查询

业务请求参数（加密前明文）

{
    "ts": 1617085650321,
    "partnerCode": 1020002,
    "bizOrderId": "1614164690110001"
}

实际请求体（加密后）

partnerAccessKey=ETHRME7LOXDT-TK&content=UgxoCGPQIzoP...

业务响应

{
    "status": 0,
    "msg": "成功",
    "data": {
        "bookerInfo": {
            "name": "张三",
            "phoneNumber": "13800138000"
        },
        "passengerList": [
            {
                "name": "张三",
                "phoneNumber": "13800138000"
            },
            {
                "name": "李四",
                "phoneNumber": "13900139000"
            }
        ]
    }
}

# 非TMC订单查询

业务请求参数（加密前明文）

{
    "ts": 1617085650321,
    "partnerCode": 1020002,
    "bizOrderId": "1614164690110002"
}

业务响应

{
    "status": 1001,
    "msg": "非TMC订单",
    "data": {}
}

# 安全说明

# 数据安全

访问控制：
- 仅支持已授权的企业通过 entId 和 accessKey 访问
- 企业只能查询属于自己的订单
数据保护：返回的手机号为完整号码，用于实际业务调用（如春秋航司会员认证）

# 隐私合规

此接口涉及用户个人信息（手机号、姓名），需要获得用户同意
数据获取、传输、存储全链路应符合隐私法规要求
建议在签约时明确用户授权范围

# 频率限制

默认限制：100次/分钟、100000次/天
如需提升限制，请参考：限频说明

# 相关接口

← 飞机票首趟航班报价查询接入须知 →