是否可通过Amadeus API验证booking reference number、E-ticket及乘客姓名

支持情况 #

Amadeus 公开API完全支持两类校验场景：预订参考号（PNR）搭配乘客姓名、电子客票号搭配乘客姓名的有效性校验，分别对应不同的专用接口。

接口调用规则 #

1. 预订参考号（PNR）校验场景 #

使用 Retrieve Reservation 接口完成校验：

• 必传参数：
  • recordLocator：6位字母/数字混合的预订参考号，注意和预订生成的编号大小写保持完全一致
  • lastName：乘客预订时填写的姓氏，拼写、特殊字符（连字符、空格、生僻字转写）需要完全匹配
• 校验判断规则：接口返回200状态码且可正常拉取到预订详情，即为校验通过；返回404状态码且错误码为 RESERVATION_NOT_FOUND，即为校验不通过。
• 注意事项：
  • 仅支持校验Amadeus GDS系统生成的PNR，其他GDS（比如Sabre、Travelport）生成的预订号无法识别
  • 多人同PNR的情况下，传入任意一位乘客的姓氏都可以匹配到预订，如需确认是指定乘客，需要在返回的预订乘客列表中二次匹配姓名信息

2. 电子客票号校验场景 #

使用 Retrieve e-Ticket 接口完成校验：

• 必传参数：
  • ticketNumber：13位纯数字电子客票号，不需要传入分隔用的横杠
  • lastName：乘客姓氏，匹配规则和PNR校验场景一致
• 校验判断规则：接口返回200状态码且客票状态不为已作废/已退票，即为校验通过；返回404状态码且错误码为 TICKET_NOT_FOUND，即为校验不通过。
• 注意事项：
  • 仅支持Amadeus渠道出票的电子客票，部分外航自有系统出票的客票可能无法查询到
  • 已使用、已改签的有效客票也可以正常返回结果，可根据自身业务需求判断是否属于有效范围

通用注意事项 #

• 调用对应接口前需要先在Amadeus开发者平台申请对应接口的调用权限，测试环境和生产环境的权限独立，需要分别申请
• 传参时不要自行对乘客姓名、编号做大小写转换、特殊字符过滤，原样传入即可，避免因参数处理导致匹配失败
• 接口默认有调用频率限制：测试环境上限为每秒10次请求，生产环境可根据自身业务用量申请调整配额

内容的提问来源于stack exchange，提问作者Irek