Ctrlk
💬 Need Help? Click Me
For the complete documentation index, see llms.txt. This page is also available as Markdown.

预订概述

Atlas API 预订流程概述，涵盖搜索、获取报价、验证、订单创建、支付、出票、标识符和订单跟进。

💬 需要帮助？ 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。

咨询 Eva

使用此部分选择正确的 Atlas API 预订流程，并在每个步骤保留正确的标识符。

从搜索到支付和跟进的预订流程

当您需要以下内容时从这里开始：

  • 了解标准的 Atlas API 预订流程

  • 在 search.do 和 getOffers.do 之间做选择

  • 查看每个步骤应保留哪个标识符

  • 在售前评估航线覆盖和原始价格

常见问题

每个步骤后应保留哪个标识符？

在 search.do 后保留 routingIdentifier。

在 verify.do 后保留 sessionId。

在 order.do 后保留 orderNo。

出票后保留航司 PNR 和 ticketNos。

对于获取报价流程，从 getOffers.do 保留 OfferId。

routingIdentifier 和 sessionId 的有效期是多久？

routingIdentifier 在 search.do 后最长有效 6 小时。

sessionId 在 verify.do 后最长有效 2 小时。

两种情况下，较短时间更安全，因为运价和库存可能更早变化。

标准的 Atlas API 预订流程是什么？

标准流程是 search.do → verify.do → order.do → pay.do → queryOrderDetails.do。

支付后轮询 不是独立的 API 步骤。

它解释了如何持续使用 queryOrderDetails.do 直到出票达到终态。

如果航司是 FR，在支付前添加 orderCommit.do。

何时应使用 getOffers.do 而不是 search.do？

当 Atlas 是您的主要购物入口点时，使用 search.do。

当您已知道目标行程或需要独立价格检查时，使用 getOffers.do。

当您需要履约路径（具有更广泛的展示规则和严格的 5 分钟出票窗口）时，使用 getOfferPrice.do。

何时应使用 priceCompareSearch.do？

在售前进行航线覆盖检查和原始价格发现时，使用 priceCompareSearch.do。

它不是标准预订流程的一部分。

不要将其视为生产环境的预订价格源。

应首先选择哪个流程？

当 Atlas 是您的主要搜索和预订层时，使用 search.do。

当目标行程已知或需要独立价格检查时，使用 getOffers.do。

仅在售前进行航线覆盖检查和原始价格发现时，使用 priceCompareSearch.do。

API 请求限制

Atlas 对选定的预订前 API 应用请求限制治理。

超限请求返回 Atlas 错误代码 429。

默认限制

  • search.do 使用 10 QPS

  • verify.do 和 getOffers.do 共享 60 QPM

  • getOfferPrice.do 使用自己的履约 QPM 策略

  • seatAvailability.do 和 getLuggage.do 共享 60 QPM

不受此策略约束的 API

order.do 和 pay.do 不属于此 QPS 和 QPM 策略的一部分。

什么计入限制

以下请求会计入：

  • 成功的请求

  • 无结果的请求

  • 业务失败和航司失败

  • 缓存命中的响应

以下请求不计入：

  • 已被 QPS 或 QPM 拒绝的请求

  • 认证、权限或验证失败

  • 幂等性阻止的重复请求（从未进入业务处理）

遇到 429 时怎么办

降低请求频率。

等待返回的 retryAfter 值后再重试。

避免立即重试循环。

有关完整策略，请使用API 请求限制。

L2B 治理

L2B（Look-to-Book）衡量交易前调用与成功支付之间的转化效率。

它独立于 QPS/QPM 请求限制。达到适用阈值时，受影响的 Verify、GetOffer、GetSeat 或 GetLuggage 方法可能进入 Cache-only。Order 和 Pay 不会因常规 L2B 治理而被降级或 Block。

请参阅 L2B 治理。

关键预订页面

预订流程中的关键标识符

在每个阶段保留并重用正确的标识符：

  • 从 search.do 获取 routingIdentifier

  • 从 verify.do 获取 sessionId

  • 从 order.do 获取 orderNo

  • 出票后从 queryOrderDetails.do 获取航司 PNR 和 ticketNos

对于获取报价路径，从 getOffers.do 保留 OfferId。

对于座位和行李查询，从 verify.do 保留 sessionId，或从 getOffers.do / getOfferPrice.do 保留 OfferId。

此部分涵盖的内容

  • 搜索航班报价

  • 通过独立的获取报价流程检索报价

  • 验证运价和航线

  • 创建订单

  • 在需要时确认 FR 订单

  • 支付和出票

  • 检索预订详情

  • 运行高级搜索流程

  • 查询座位

  • 查询行李

应选择哪个流程？

标准搜索流程

当 Atlas 是您的主要搜索和预订层时使用此流程。

此路径首先使用 search.do，然后在预订前使用 verify.do。

获取报价流程

当行程已知或需要在订单创建前进行独立价格检查时使用此流程。

此路径以 getOffers.do 开始，并使用 OfferId。

履约流程

当您需要更广泛的报价可见性且您的系统可以立即执行支付时使用此流程。

此路径以 getOfferPrice.do 开始，并在订单创建后应用 5 分钟支付和出票窗口。

价格比较搜索

当您需要售前覆盖可见性和原始价格信号时使用此流程。

此路径使用 priceCompareSearch.do。

它不替代标准预订流程。

流程摘要

标准预订流程

使用 search.do → verify.do → order.do → pay.do → queryOrderDetails.do。

仅在需要时在订单前插入附加服务。

仅在 FR 航司时在支付前插入 orderCommit.do。

有关完整的分步顺序，请使用标准预订流程。

如何包含座位和行李

将座位和行李视为预订流程中的可选附加项。

仅当附加销售是产品的一部分且流程支持时，才使用 getLuggage.do 和 seatAvailability.do。

在支付前使用它们以提高旅客清晰度和订单转化率。

仅使用有效的 sessionId 或 OfferId 调用 seatAvailability.do。

不要仅根据航班数据调用它。

获取报价流程

使用 getOffers.do → order.do → pay.do → queryOrderDetails.do。

仅在需要时在订单前插入附加服务。

仅在 FR 航司时在支付前插入 orderCommit.do。

有关完整的分步顺序，请使用获取报价流程。

履约流程

使用 getOfferPrice.do → order.do → pay.do → queryOrderDetails.do。

仅在需要时在订单前插入附加服务。

将 5 分钟支付和出票窗口视为严格的。

有关完整的分步顺序，请使用履约流程。

pay.do 之后会发生什么？

不要假设支付和最终出票在同一时刻发生。

使用 queryOrderDetails.do 直到订单达到最终出票状态。

Webhook 可以提供帮助，但不应该是您唯一的确认路径。

主要 API

  • search.do

  • priceCompareSearch.do

  • getOffers.do

  • getOfferPrice.do

  • verify.do

  • order.do

  • orderCommit.do

  • pay.do

  • queryOrderDetails.do

  • smartSearch.do

  • seatAvailability.do

  • getLuggage.do

按任务推荐的下一个页面

选择正确的预订路径

使用：

构建标准流程

使用：

构建支付和跟进

使用：

添加座位和行李

使用：

将这里的附加服务视为可选的添加项，而不是强制性的预订步骤。

构建备选报价路径

使用：

构建履约路径

使用：

评估售前航线覆盖

使用：

在以下情况下使用此部分

  • 标准的搜索到出票流程

  • 独立的报价查询和价格检查流程

  • 售前航线覆盖和原始价格检查

  • 适用时的 FR 订单确认支持

  • 座位和行李追加销售

  • 实时或智能搜索选项

完整 API 参考

在此查看端点级详情：

预订 API

相关页面

Previous预订
Next标识符

Last updated

Was this helpful?