📣Atlas API 文档更新
Atlas API 文档最新更新、新指南、故障排除变更及推荐后续阅读。
使用此页面追踪 Atlas API 文档的最新更新，并更快地跳转到合适的指南。
当您需要最新的指南、修订后的故障排除内容或新增的入口点时，请将此页面作为支持与参考的更新动态。
最新更新：所有 Atlas API 请求现在必须发送 Accept: */*。
此页面突出显示新指南、主要的故障排除改进以及按使用场景推荐的后续阅读页面。
如果您需要以下内容，请从此处开始：
查找最新的 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 文档以显示当前支持的航司范围。
变更内容：
记录了覆盖美洲、欧洲、日本和韩国的 23 家支持 VOID 的航司
标记
ZG仅支持美国航线新增最新支持的航司：
TS、Y4、EI和VF
后续阅读：
Fulfillment API 和 getOfferPrice.do 发布
发布了 getOfferPrice.do 流程的新履约指南，并更新了关键预订页面，包含其时间限制和请求限制规则。
变更内容：
新增Fulfillment API，用于新的面向履约的预订路径
新增Get Offer vs Fulfillment API，明确何时使用
getOffers.do与getOfferPrice.do在 API 参考下新增获取报价价格
后续阅读：
支付超时、瞬态失败和重复预订说明包
发布了三个新页面，用于支付截止恢复、瞬态预订阶段失败和重复预订处理。
变更内容：
新增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
后续阅读：
支付状态和辅助服务时效性说明包
发布了三个新页面，用于支付恢复、辅助服务复用安全性和流程重启决策。
变更内容：
新增402 vs 404 vs 406 vs 615，明确何时应查询订单、等待或避免再次调用
pay.do新增行李与座位产品代码时效性，解释辅助服务选择何时过期
新增从搜索 vs 验证 vs 获取报价重启，解释必须重新运行的最早预订步骤
后续阅读：
预订恢复和时机说明包
发布了三个新页面，用于预订阶段恢复决策和支付后跟进。
变更内容：
新增202 vs 301 vs 308，解释何时应刷新搜索、刷新验证或重建预订上下文
新增验证 vs 创建订单，明确预订创建前的验证边界
新增轮询与出票时机，解释为什么支付成功并不总是意味着最终出票
后续阅读：
预订流程说明包
发布了三个新页面，针对流程选择、标识符处理和请求压力故障排除等常见集成问题。
变更内容：
新增标识符，涵盖
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.voidwebhook 覆盖范围、状态值和重试失败行为
后续阅读：
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 辅助开发，发布了沙箱验证测试工具包，并改进了错误码作为故障排除入口点。
沙箱集成应该先阅读哪个指南？
从快速入门开始。然后使用沙箱验证测试工具包在编码前确认就绪状态。
预订、支付或故障排除应该从哪里开始？
使用预订概述了解主要流程，使用支付与出票了解支付和轮询，使用错误码了解失败处理。
完整变更日志
新增 Fulfillment API 和 getOfferPrice.do
发布了 getOfferPrice.do 的新履约预订路径，并更新了关键工作流页面，包含履约特定的时间限制和请求限制指南。
变更内容：
新增Fulfillment API，用于履约定位、5 分钟时间限制、重试规则和恢复指南
新增Get Offer vs Fulfillment API，区分标准 Get Offer 与履约路径
在 API 参考下新增获取报价价格
更新预订概述，新增履约分支
更新获取报价，区分
getOffers.do和getOfferPrice.do更新订单与出票，将标准的 30 分钟保留与履约流程分开
更新API 请求限制，记录独立的
getOfferPrice.doQPM 策略
新增标识符、流程选择和限流指南
发布了十五个新的支持页面，用于常见的预订流程集成问题。
变更内容：
新增标识符，涵盖
routingIdentifier、sessionId、OfferId、orderNo和刷新规则新增搜索 vs 获取报价，明确何时使用
search.do以及何时使用getOffers.do新增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，明确过期的辅助服务代码与行李航段映射错误
新增座位回退模式，解释
STOP_TICKET、STOP_SEAT和SIMILAR_SEAT新增401 vs 402 vs 404，明确支付截止过期与不可支付或已支付的订单
新增205 vs 299 vs 304，明确瞬态验证和订单失败
新增318 vs 608 重复预订，明确另一次重试前的重复预订处理
更新的页面：
新增多渠道通知设置指南
发布了多渠道通知，支持通过 Webhook、邮件、钉钉、企业微信、Slack 和 Teams 进行 ATRIP 投递。
变更内容：
新增渠道选择、ATRIP 设置和测试通知的指南
在 Webhook 概述中明确 Webhook 是更广泛通知模型中的一种投递选项
更新航司状态更新通知，将航司状态定位为首个多渠道应用场景
更新的页面：
新增 MCP 辅助开发
发布了MCP 辅助开发，面向在 Atlas API 集成过程中使用 GitBook MCP 的团队。
当您需要以下内容时使用它：
在编码前找到正确的工作流
了解下一步需要使用哪个标识符或 API
从开发问题跳转到正确的参考或故障排除页面
该指南还包含了生产安全开发的提示模式和用法边界。
新增沙箱验证测试工具包
发布了沙箱验证测试工具包，用于无代码沙箱验证运行。
当您需要以下内容时使用它：
在开发前确认凭证和网络访问
使用 Newman 运行核心沙箱成功路径
一次性验证
搜索、验证、下单和支付在环境变更后快速检查沙箱就绪状态
该页面还解释了出票轮询期间预期的最终检索超时。
Last updated
Was this helpful?