For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

📣Atlas API 文档更新

按时间倒序记录 Atlas API 文档的重要更新。

本页按时间倒序记录 Atlas API 文档的重要更新。每条记录说明变更内容及受影响的页面。

完整变更日志

下线 Smart Search 文档入口

下线 smartSearch.do 的公开文档入口,并收敛至当前支持的搜索路径。

变更内容:

  • 移除 Smart Search 的公开流程、链接和故障排查说明

  • 新集成请使用 search.do 及当前预订流程

  • 本次为文档更新,不涉及接口请求、响应或运行行为变更

更新的页面:

更新 VCC Passthrough 使用指南

更新 VCC Passthrough 使用指南,补充接入、测试和异常处理说明。

变更内容:

  • 新增沙箱测试、换卡、重试、重新生单、常见问题和航司支持范围

  • 明确订单级 supportPaymentMethods 判断、pay.do 受理与最终出票成功的区别

  • 本次为文档更新,不涉及接口请求、响应或支付规则变更

更新的页面:

发布航司乘机人必填字段说明

发布航司乘机人必填字段说明,帮助接入方确认和处理乘机人信息要求。

变更内容:

  • 说明动态 Verify 配置、静态配置参考和 605 错误处理

  • 本次为文档更新,不涉及接口请求、响应或乘机人信息处理规则变更

更新的页面:

更新 VOID 航司覆盖范围

更新当前的 VOID 航司覆盖范围。

变更内容:

  • 新增 Q6 和 N3

  • 移除 TS

  • VOID 现支持横跨四个地区的 24 家航司

  • 保留 ZG 仅限美国航线的限制

更新的页面:

补充客户 VCC 透传限制

更新 VCC Passthrough,明确 Atlas 整体支付能力与客户自有 VCC 透传能力的区别。

变更内容:

  • 增加航司、航线、渠道和卡组织限制

  • 明确部分航司暂未开放客户 VCC 透传

  • 标注已确认 Mastercard VCC 可用的航司

请以 ATRIP 实时配置为准。

启动 L2B 治理灰度

Atlas 使用 Warning、接口级 Cache-only 和自动恢复,替代常规 L2B Block。

变更内容:

  • 新增 L2B 治理,说明阈值、状态、缓存行为和客户端处理

  • 明确 QPS/QPM 请求限制与 L2B 转化效率治理相互独立

  • 更新 Verify、Get Offer、座位和行李流程,说明 Cache-only 响应处理

  • 明确 order.do 和 pay.do 不会因常规 L2B 治理降级或 Block

  • 扩展多渠道通知,覆盖 L2B 状态转换

灰度客户会由 Atlas 提前单独沟通。全量开放时间将另行公布。

要求使用 Accept: */*

所有 Atlas API 请求现在必须发送 Accept: */*。

Atlas 可根据响应的 Content-Type 返回任意内容类型。使用通配符可确保客户端接受这些响应,并保持 gzip 传输正常。

不要发送 Accept: application/json。该设置可能导致 gzip 传输异常,并使接口返回错误。

新增了常见问题和服务端原始错误描述,帮助快速定位错误的 Accept 配置。

更新的页面:

发布 OTA 随单行李加购

Atlas 现支持 OTA 在 order.do 请求中传入已售行李。

变更内容:

  • 新增可选的 passengerBaggages 请求字段

  • 支持按乘机人和航段传入行李规格、售价与币种

  • 航司实际价格高于 OTA 售价时返回 3011

  • 客户可在 30 分钟内确认亏出或取消订单

  • 行李盈余和亏损在月底统一结算

更新的页面:

扩展 VOID 航司覆盖范围

更新了 VOID 文档以反映当前支持的航司范围。

变更内容:

  • 记录了覆盖四个地区的 23 家支持 VOID 的航司

  • 将 TS、Y4、EI 和 VF 添加到支持的覆盖列表

  • 明确了 ZG 支持仅限于美国航线

更新的页面:

新增 Fulfillment API 和 getOfferPrice.do

发布了 getOfferPrice.do 的新履约预订路径,并更新了关键工作流页面,包含履约特定的时间限制和请求限制指南。

变更内容:

新增标识符、流程选择和限流指南

发布了十五个新的支持页面,用于常见的预订流程集成问题。

变更内容:

更新的页面:

新增 QPS 和 QPM 请求限制指南

更新了预订、故障排除和常见问题页面,记录选定预订前 API 的请求限制治理。

变更内容:

  • 新增 Atlas 错误码 429 指南,附带 retryAfter

  • 记录了搜索、履约和辅助服务资源池的默认限制

  • 明确了 verify.do 和 getOffers.do 共享一个履约池

  • 明确了 seatAvailability.do 和 getLuggage.do 共享一个辅助服务池

  • 确认 order.do 和 pay.do 不在本次请求限制策略范围内

更新的页面:

新增多渠道通知设置指南

发布了多渠道通知,支持通过 Webhook、邮件、钉钉、企业微信、Slack 和 Teams 进行 ATRIP 投递。

变更内容:

  • 新增渠道选择、ATRIP 设置和测试通知的指南

  • 在 Webhook 概述中明确 Webhook 是更广泛通知模型中的一种投递选项

  • 更新航司状态更新通知,将航司状态定位为首个多渠道应用场景

更新的页面:

从标准请求头中移除了 Accept: application/json

更新了沙箱访问指南,使标准请求头与当前使用保持一致。

变更内容:

  • 从标准请求头列表中移除了 Accept: application/json

  • 其余标准请求头指南保持不变

更新的页面:

更新 UAT 验证以适应 ATRIP UAT 测试

更新了 UAT 指南以反映最新的 ATRIP 流程。

变更内容:

  • UAT 现在从 UAT 测试 开始

  • 合作伙伴选择目标功能范围后才能继续

  • 航班预订 现被记录为必需的核心功能

  • 确认并继续 和 提交验证 现已成为文档流程的一部分

  • 失败案例现在直接指向 ATRIP 失败原因

更新的页面:

扩展作废工作流和 webhook 指南

更新了作废文档以反映当前的预订后流程。

变更内容:

  • 明确了标准的 voidQuotation.do → void.do → queryVoidOrders.do 顺序

  • 新增 voidOfferId、voidCode 和严格作废窗口处理的指南

  • 扩展了 order.void webhook 触发规则、状态值和重试失败行为

更新的页面:

更新 SeatAvailability 调用规则

更新了座位选择文档以反映最新的 seatAvailability.do 要求。

变更内容:

  • 独立模式不再可用

  • 使用 verify.do 的 sessionId 或 getOffers.do 的 OfferId

  • 仅查询航班座位报价的请求不受支持

更新的页面:

新增 MCP 辅助开发

发布了MCP 辅助开发,面向在 Atlas API 集成过程中使用 GitBook MCP 的团队。

当您需要以下内容时使用它:

  • 在编码前找到正确的工作流

  • 了解下一步需要使用哪个标识符或 API

  • 从开发问题跳转到正确的参考或故障排除页面

该指南还包含了生产安全开发的提示模式和用法边界。

新增沙箱验证测试工具包

发布了沙箱验证测试工具包,用于无代码沙箱验证运行。

当您需要以下内容时使用它:

  • 在开发前确认凭证和网络访问

  • 使用 Newman 运行核心沙箱成功路径

  • 一次性验证 搜索、验证、下单 和 支付

  • 在环境变更后快速检查沙箱就绪状态

该页面还解释了出票轮询期间预期的最终检索超时。

改进错误码落地页面

更新了错误码,新增:

  • 重试策略指南

  • 高频错误码快速决策表

  • 重试时应避免的高风险错误

  • 基于模式的常见集成问题检查

这使该页面作为主要的故障排除入口点更加有用。

新增混合支付指南

在支付与出票下发布了混合支付指南。

当您需要以下内容时使用它:

  • 从 VCC 直通切换为押金

  • 决定是复用还是重新生成订单

  • 处理 ATRIP 和 API 流程中的混合支付回退

历史导航与更新摘要

客户 VCC 透传限制更新

已更新 VCC Passthrough,说明客户自有 VCC 的额外支付限制。

包括 TR、AK、VF、U2、XQ、6E、7C、RS、BC、HP 和 GE。

请以 ATRIP 实时配置为准。

如果您需要以下内容,请从此处开始:

  • 查找最新的 Atlas API 指南

  • 查看沙箱、预订、支付或故障排除方面的变更

  • 选择下一步要阅读的合适页面

常见问题

Atlas API 文档最近有什么变化?

最近的更新要求所有请求发送 Accept: */*,以支持服务器返回的任意 Content-Type 并确保 gzip 传输正常。Accept: application/json 不受支持。

当您需要页面级别的详细信息时,请使用下面的变更日志。

新集成团队应该从哪里开始?

从快速入门开始。

然后使用集成指南、预订概述和错误码。

我应该查看哪些页面了解请求限制指南?

从预订概述、搜索、搜索与预订和错误码开始。

热门起点

新集成

从快速入门和集成指南开始。

预订流程

从预订概述和搜索与预订开始。

当您需要下一步的正确令牌时,请使用标识符。

当预订边界是主要问题时,请使用验证 vs 创建订单。

当主要问题是从何处重新开始时,请使用从搜索 vs 验证 vs 获取报价重启。

当付费座位失败行为必须在预订前定义时,请使用座位回退模式。

故障排除

从错误码和常见问题开始。

当请求频率或搜索并发是主要问题时,请使用429 vs 110。

当您需要知道哪个更早的步骤必须被刷新时,请使用202 vs 301 vs 308。

当主要风险是重复或不必要的支付重试时,请使用402 vs 404 vs 406 vs 615。

当订单输入或辅助服务映射是主要故障区域时,请使用307 vs 327 vs 410和309 vs 409。

当主要问题是订单是否已过期或已支付时,请使用401 vs 402 vs 404。

最新的 Atlas API 文档更新

OTA 随单行李加购发布

Atlas 支持 OTA 在创建机票订单时随单传入已售行李。

变更内容:

  • order.do 支持可选的 passengerBaggages 请求字段

  • 记录乘机人、航段、规格、售价和币种的传参规则

  • 新增 309、3011、确认亏出和月底结算说明

后续阅读:

VOID 航司覆盖范围更新

更新了 VOID 文档以显示当前支持的航司范围。

变更内容:

  • 记录了覆盖美洲、欧洲、日本和韩国的 24 家支持 VOID 的航司

  • 标记 ZG 仅支持美国航线

  • 新增 Q6 和 N3

  • 移除 TS

后续阅读:

Fulfillment API 和 getOfferPrice.do 发布

发布了 getOfferPrice.do 流程的新履约指南,并更新了关键预订页面,包含其时间限制和请求限制规则。

变更内容:

后续阅读:

支付超时、瞬态失败和重复预订说明包

发布了三个新页面,用于支付截止恢复、瞬态预订阶段失败和重复预订处理。

变更内容:

  • 新增401 vs 402 vs 404,区分已过期的支付窗口与不可支付或已支付的订单状态

  • 新增205 vs 299 vs 304,明确何时应重试一次、从搜索重新开始或升级瞬态验证和订单失败

  • 新增318 vs 608 重复预订,明确在重试前如何确认现有预订状态

后续阅读:

输入验证和座位回退说明包

发布了三个新页面,用于订单输入故障排除、辅助服务映射和座位失败行为。

变更内容:

  • 新增307 vs 327 vs 410,区分通用订单字段问题、预订要求不匹配和联系电话格式错误

  • 新增309 vs 409,区分过期的辅助服务代码与行李航段映射错误

  • 新增座位回退模式,解释 STOP_TICKET、STOP_SEAT 和 SIMILAR_SEAT

后续阅读:

支付状态和辅助服务时效性说明包

发布了三个新页面,用于支付恢复、辅助服务复用安全性和流程重启决策。

变更内容:

后续阅读:

预订恢复和时机说明包

发布了三个新页面,用于预订阶段恢复决策和支付后跟进。

变更内容:

后续阅读:

预订流程说明包

发布了三个新页面,针对流程选择、标识符处理和请求压力故障排除等常见集成问题。

变更内容:

  • 新增标识符,涵盖 routingIdentifier、sessionId、OfferId、orderNo 和新鲜标识符规则

  • 新增搜索 vs 获取报价,明确何时使用 search.do 与 getOffers.do

  • 新增429 vs 110,区分请求限制治理与搜索并发压力

后续阅读:

QPS 和 QPM 请求限制治理

发布了选定预订前 API 的新请求限制指南。

变更内容:

  • 记录了 Atlas 错误码 429 在超限请求时的行为

  • 新增 verify.do 和 getOffers.do 的共享池规则,以及 seatAvailability.do 和 getLuggage.do 的共享池规则

  • 新增 retryAfter、请求节奏和减少重复搜索的重试指南

后续阅读:

多渠道通知发布

发布了新的 Atlas 通知设置指南,支持通过 Webhook、邮件、钉钉、企业微信、Slack 和 Teams 进行 ATRIP 投递。

变更内容:

  • 新增多渠道通知的 ATRIP 设置指南

  • 明确 Webhook 是通知模型中的一种投递选项

  • 将航司状态更新链接到首个多渠道应用场景

后续阅读:

Accept 请求头要求

更新了沙箱访问指南,明确 Accept 请求头的必填值。

变更内容:

  • 所有请求必须包含 Accept: */*

  • 服务器可按响应 Content-Type 返回任意内容类型

  • 不要发送 Accept: application/json

  • 此要求可避免 gzip 传输异常和接口错误

  • 新增常见问题和服务端原始错误描述

后续阅读:

UAT 测试流程更新

更新了 UAT 文档以反映当前的 ATRIP 验证流程。

变更内容:

  • UAT 现在从 UAT 测试 开始

  • 合作伙伴必须选择目标功能范围后才能继续

  • 航班预订 是必需的核心功能

  • 提交验证 现在触发自动验证并直接返回失败原因

后续阅读:

作废工作流和通知更新

更新了作废文档以反映当前的预订后流程和 webhook 处理。

变更内容:

  • 明确了标准流程:voidQuotation.do → void.do → queryVoidOrders.do

  • 增加了对 voidOfferId、voidCode 和作废窗口检查的更强指南

  • 扩展了 order.void webhook 覆盖范围、状态值和重试失败行为

后续阅读:

SeatAvailability 调用规则更新

更新了座位选择指南以反映当前的 seatAvailability.do 调用规则。

变更内容:

  • 独立模式不再可用

  • seatAvailability.do 现在需要来自 verify.do 的 sessionId 或来自 getOffers.do 的 OfferId

  • 仅查询航班座位报价的请求不受支持

后续阅读:

MCP 辅助开发

当您希望在 Atlas API 集成过程中使用 GitBook MCP 时,请阅读 MCP 辅助开发。

适用于:

  • 开始沙箱构建的团队

  • 绘制预订流程的开发人员

  • 希望更快找到实现问题答案的团队

后续阅读:

沙箱验证测试工具包

当您在开发前或环境变更后需要进行无代码沙箱验证运行时,请阅读沙箱验证测试工具包。

适用于:

  • 在编码前验证沙箱凭证

  • 确认网络访问和核心预订流程就绪

  • 在凭证或 IP 变更后重新检查沙箱健康状态的团队

后续阅读:

错误码改进

错误码 现在作为主要的故障排除入口点效果更好。

适用于:

  • 处理高频集成失败的团队

  • 定义安全重试行为的开发人员

  • 检查可能根本原因的运维团队

后续阅读:

按使用场景开始

新的 Atlas API 集成

从以下内容开始:

沙箱验证

从以下内容开始:

预订和支付流程

从以下内容开始:

故障排除与支持

从以下内容开始:

常见问题

Atlas API 文档最近有什么变化?

最近的更新新增了标识符、搜索 vs 获取报价、429 vs 110、202 vs 301 vs 308、验证 vs 创建订单、轮询与出票时机、402 vs 404 vs 406 vs 615、行李与座位产品代码时效性、从搜索 vs 验证 vs 获取报价重启、307 vs 327 vs 410、309 vs 409、座位回退模式、401 vs 402 vs 404、205 vs 299 vs 304和318 vs 608 重复预订,为选定的预订前 API 增加了 QPS 和 QPM 请求限制指南,新增了多渠道通知用于 ATRIP 通知设置,将新的 ATRIP UAT 测试流程添加到UAT 验证,明确了航班预订是必需的,增加了自动验证指南,扩展了作废工作流,更改了 seatAvailability.do 的调用规则,新增了MCP 辅助开发,发布了沙箱验证测试工具包,并改进了错误码作为故障排除入口点。

沙箱集成应该先阅读哪个指南?

从快速入门开始。然后使用沙箱验证测试工具包在编码前确认就绪状态。

预订、支付或故障排除应该从哪里开始?

使用预订概述了解主要流程,使用支付与出票了解支付和轮询,使用错误码了解失败处理。

历史导航与更新摘要

按日期倒序查阅上方日志,了解每次文档更新的完整范围。

常用入口

历史重点

  • 客户 VCC 透传限制以 ATRIP 实时配置为准。

  • Accept: */* 是所有 Atlas API 请求的必填请求头。

  • 沙箱、预订、支付和故障排除入口见上方常用入口。

Last updated

Was this helpful?