API 请求限制

Atlas API 针对选定预订前 API 的 QPS 和 QPM 请求限制规则，包括共享池、429 处理和重试指导。

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

咨询 Eva

当您需要在一个位置查看请求限制规则时，使用此页面。

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

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

本页说明 QPS/QPM 请求速率限制。

Look-to-Book 转化效率治理采用独立规则。它不会返回常规 L2B Block，而可能让受影响的交易前方法进入 Cache-only。请参阅 L2B 治理。

受影响的 API

以下 API 受此策略约束：

search.do
verify.do
getOffers.do
seatAvailability.do
getLuggage.do

以下 API 不受此策略约束：

order.do
pay.do

默认限制

搜索资源

search.do — 10 QPS

Atlas 在滚动 1 秒窗口中计算搜索次数。

履约资源

verify.do + getOffers.do — 共享 60 QPM

Atlas 在滚动 60 秒窗口中计算履约次数。

附加服务资源

seatAvailability.do + getLuggage.do — 共享 60 QPM

Atlas 在滚动 60 秒窗口中计算附加服务次数。

共享池规则

verify.do 和 getOffers.do 共享一个履约池。

一个 API 的高流量会消耗另一个 API 的池。

seatAvailability.do 和 getLuggage.do 共享一个附加服务池。

一个 API 的高流量会消耗另一个 API 的池。

什么计入限制

以下请求会计入：

成功的请求
无结果的请求
业务失败和航司失败
缓存命中的响应

以下请求不计入：

已被请求限制治理拒绝的请求
认证失败
参数验证失败
权限或安全策略拒绝
幂等性阻止的重复请求（从未进入业务处理）

`429` 响应

当请求超过当前限制时，Atlas 返回错误代码 429。

响应示例

{
  "code": 429,
  "message": "Rate limit exceeded. Please retry after the current window resets",
  "limitType": "SEARCH_QPS",
  "limit": 1,
  "retryAfter": 1
}

字段含义

code — 错误代码
message — 错误摘要
limitType — 当前限制桶
limit — 当前配置的限制
retryAfter — 重试前等待的秒数

如何处理 429

降低请求频率。

等待 retryAfter 后再重试。

不要立即并行重试。

尽可能使用缓存。

在到达 Atlas 之前合并重复请求。

按 API 的实践指导

搜索

对重复的航线和日期查询使用本地缓存。

平滑每秒的突发流量。

验证和获取报价

不要在紧密循环中重复检查同一行程。

在预订条件未改变时，重用新鲜的验证或报价上下文。

座位和行李

除非预订上下文发生变化，否则不要重新查询附加服务。

在当前 sessionId 或 OfferId 仍然有效时重用它。

常见问题

`429` 是否意味着账户被封禁？

不是。

它仅表示当前请求频率超过了配置的限制。

缓存命中的请求是否计入？

是的。

如果请求进入 Atlas 业务处理并返回结果，则会计入。

可以请求更高的限制吗？

可以。

如果您的业务需要更高的吞吐量，请联系您的 Atlas 客户经理或业务团队。