Bybit API 调用次数如何查？掌握速率限制，交易更高效！

频道： 新闻 日期： 浏览：48

Bybit API 调用次数限制如何查询

在加密货币交易的世界里，API（应用程序编程接口）扮演着至关重要的角色。它允许开发者和交易者以编程方式访问交易所的数据和功能，从而实现自动化交易、数据分析等高级应用。Bybit 作为一家领先的加密货币衍生品交易所，提供了强大的 API 供用户使用。然而，为了确保系统的稳定性和公平性，Bybit 对 API 的调用次数进行了限制，称为速率限制 (Rate Limit)。了解并监控这些速率限制对于高效使用 Bybit API 至关重要，可以避免因超出限制而导致 API 请求失败，影响交易策略的执行。本文将详细介绍如何查询 Bybit API 的调用次数限制。

理解 Bybit API 速率限制

在深入了解查询方法之前，务必理解 Bybit API 速率限制这一基本概念。速率限制是 API 服务提供商为了保障服务器稳定性和防止滥用而设置的一种机制，它限制了客户端在特定时间段内可以发送的 API 请求数量。Bybit 的速率限制通常以 "请求数/时间窗口" 的形式呈现，例如 "100 requests/minute"， 或者更精细化的 "10 requests/second"。这明确表示，在 1 分钟或 1 秒内，你最多可以发送 100 个或 10 个 API 请求。

必须强调的是，Bybit 针对不同的 API 接口实施了不同的速率限制策略。例如，获取公开市场数据的 API 接口，由于其数据访问量相对较大且对服务器压力较小，因此往往拥有比下单交易接口更高的速率限制。这是因为下单交易接口涉及到资金流动和系统安全，需要更严格的控制。速率限制还可能受到你的账户级别、API 密钥类型（例如，测试网与主网的密钥限制不同）或特定促销活动的影响而有所差异。部分 VIP 用户可能享有更高的速率限制，而使用 WebSocket API 可能会有不同的计算方式。因此，在正式使用 Bybit API 之前，务必详细研读官方文档中关于速率限制的章节，准确掌握每个接口的当前速率限制标准。务必关注官方的更新公告，因为速率限制可能会根据市场情况和系统负载进行调整。

查询 Bybit API 调用次数限制的方法

查询 Bybit API 调用次数限制主要依赖于 HTTP 响应头信息。当你发送一个 API 请求到 Bybit 服务器时，服务器会在响应头中返回详细的速率限制信息，这些信息对监控 API 使用情况和避免超过限制至关重要。 理解这些信息可以确保你的应用程序的稳定性和可靠性。

以下列出了几种常用的查询方法，这些方法允许你分析 HTTP 响应头以获取速率限制的详细信息：

1. 查看 HTTP 响应头：

每次调用 Bybit API 后，检查 HTTP 响应头。 响应头通常包含以下关键字段，用于指示速率限制：

- X-RateLimit-Limit : 这个字段表示在特定时间窗口内允许的最大请求数量。 它定义了 API 调用次数的绝对上限。

- X-RateLimit-Remaining : 这个字段表示当前时间窗口内剩余的可用请求数量。 这是一个动态值，随着每次 API 调用而减少。

- X-RateLimit-Reset : 这个字段表示速率限制重置的时间，通常以 Unix 时间戳的形式表示。 了解这个时间戳可以预测何时可以再次发送请求而不受限制。

2. 使用编程语言的 HTTP 客户端：

在你的代码中，使用编程语言（如 Python、JavaScript、Java 等）的 HTTP 客户端库来发送 API 请求，并解析响应头。 例如，在 Python 中，你可以使用 requests 库： 


import requests

response = requests.get('https://api.bybit.com/v5/market/tickers?category=spot&symbol=BTCUSDT')

limit = response.headers['X-RateLimit-Limit']
remaining = response.headers['X-RateLimit-Remaining']
reset = response.headers['X-RateLimit-Reset']

print(f"Rate Limit: {limit}")
print(f"Remaining: {remaining}")
print(f"Reset Time: {reset}")

这段代码展示了如何从响应头中提取速率限制信息。 务必根据你的编程语言选择合适的 HTTP 客户端库。

3. 使用 API 密钥进行身份验证：

确保你的 API 请求包含有效的 API 密钥。不同的 API 密钥可能具有不同的速率限制。通过 API 密钥进行身份验证，Bybit 可以跟踪你的 API 使用情况并应用相应的速率限制策略。

4. Bybit 官方 API 文档：

查阅 Bybit 官方 API 文档，以获取有关速率限制的最新信息和最佳实践。文档通常会详细说明不同 API 端点的速率限制策略，以及如何有效地管理 API 调用。

5. 注意事项：

- 如果你的应用程序频繁超出速率限制，请考虑优化你的 API 调用策略，例如减少请求频率或批量处理请求。 避免不必要的 API 调用可以显著减少超出限制的风险。

- 处理 429 Too Many Requests 错误。 当超出速率限制时，Bybit 服务器会返回此错误代码。你的应用程序应该能够正确处理此错误，并采取适当的措施，例如暂停发送请求并在速率限制重置后重试。

- 监控 API 使用情况。 定期监控你的 API 使用情况，以便及时发现并解决潜在的速率限制问题。 可以使用日志记录和监控工具来跟踪 API 调用和速率限制状态。

1. 通过 HTTP 响应头信息获取

这是监控 Bybit API 速率限制最直接且常用的方法。当你向 Bybit API 发送请求并收到响应时，务必检查响应的 HTTP 头部信息。这些头部信息包含了关于速率限制的关键数据，帮助你了解当前 API 使用情况，避免触发速率限制。

  • X-RateLimit-Limit : 此字段标明了在特定时间窗口内，你的 API 密钥允许发送的最大请求数量。它代表了你被允许的请求配额。理解这个数值是有效管理 API 使用的基础。
  • X-RateLimit-Remaining : 此字段指示了在当前时间窗口内，你剩余的可用 API 请求数量。它的数值会随着每次 API 请求而递减。通过持续监控这个值，你可以预判何时会接近速率限制。
  • X-RateLimit-Reset : 此字段提供了当前速率限制时间窗口重置的时间戳，通常以 Unix 时间戳（秒）的形式呈现。利用这个时间戳，你可以计算出下一个时间窗口何时开始，从而规划你的 API 请求发送策略。

通过解析这些 HTTP 头部信息，你可以实时监控 API 调用的速率限制状态。例如，若 X-RateLimit-Remaining 的值显著降低并接近于 0，这表明你即将达到速率限制阈值。此时，你应该立即采取措施，例如降低请求发送频率或优化你的请求逻辑，以避免 API 调用被限制。

示例 (Python 代码):

import requests

在Python中，`requests`库是一个广泛使用的HTTP客户端库，它允许你发送HTTP请求（如GET, POST, PUT, DELETE等）到指定的URL，并处理服务器返回的响应。这对于与Web API交互，例如从交易所获取加密货币数据，至关重要。你需要先使用`pip install requests` 安装此库。

你的 API 密钥和密钥

为了安全地访问和使用加密货币交易所或相关服务的API，您需要一对密钥：API密钥（ api_key ）和API密钥Secret（ api_secret ）。API密钥就像您的用户名，用于标识您的账户。API密钥Secret则类似于您的密码，用于验证您的身份并授权您执行特定的操作。请务必妥善保管您的API密钥Secret，切勿泄露给他人，因为它能允许他人以您的身份执行交易或访问您的账户信息。

在代码中，您需要将 YOUR_API_KEY 替换为您实际的API密钥，并将 YOUR_API_SECRET 替换为您实际的API密钥Secret。以下是Python代码示例： 

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

重要提示：

  • 安全性： 切勿将您的API密钥Secret硬编码到公开的代码仓库中（例如GitHub）。使用环境变量或其他安全的方式存储和访问您的密钥。
  • 权限控制： 某些API允许您设置密钥的权限。根据您的需求，只授予密钥必要的权限，以降低潜在的安全风险。
  • 定期更换： 定期更换您的API密钥，以进一步提高安全性。
  • 保护措施： 启用双因素身份验证（2FA）和IP白名单等安全措施，以保护您的账户免受未经授权的访问。

正确使用和保护您的API密钥至关重要，可以确保您的资金和数据的安全。如果不小心泄露了您的API密钥Secret，请立即禁用或更换它，并联系相关交易所或服务提供商。

Bybit API 的基础 URL

与 Bybit API 的所有交互都以一个清晰定义的基础 URL 开始，该 URL 构成了所有 API 请求的入口点。当前，Bybit 的主 API 服务器的基础 URL 设置为：

base_url = "https://api.bybit.com"

此 URL 是您构建所有后续 API 请求的根。 理解这一点至关重要，因为所有端点（例如交易、账户信息或市场数据）都将附加到此基础 URL。错误的基础 URL 将导致请求失败。

需要注意的是，Bybit 可能会根据环境（例如，测试网与生产环境）或 API 版本更新此基础 URL。因此，始终查阅 Bybit 官方 API 文档，以获取最新和最准确的基础 URL 信息。使用过时的 URL 可能会导致意外的结果或错误的数据。

请确保您的代码或配置能够灵活地处理潜在的 URL 变更，以便在 Bybit 做出更改时保持应用程序的稳定性和可靠性。例如，可以将基础 URL 存储在一个可配置的变量中，而不是在代码中硬编码。

在某些情况下，Bybit 可能会提供多个基础 URL，用于不同的区域或服务器集群。选择正确的基础 URL 可以优化延迟并提高 API 调用的性能。请根据您的地理位置和使用案例选择最合适的 URL。

你要调用的 API 接口

在加密货币交易或数据分析中，与交易所或数据提供商的API（应用程序编程接口）进行交互是至关重要的。API允许开发者以编程方式访问实时市场数据、执行交易、管理账户等。本例以获取交易对信息为例，介绍API端点的概念。

endpoint = "/v2/public/tickers" # 以获取交易对信息为例

API 端点 (Endpoint) ：API 端点是 API 服务中暴露出来的特定 URL，客户端（你的程序或应用）通过向这些 URL 发送请求来执行特定操作。每个端点通常对应于 API 提供的一种特定功能或数据类型。在上述例子中， /v2/public/tickers 就是一个端点，它通常用于获取所有或指定交易对的最新价格、交易量和其他相关信息。

端点的结构： 端点通常由基本 URL（例如交易所的 API 服务器地址）和路径组成。 /v2/public/tickers 是相对于基本 URL 的路径。完整的 API 请求 URL 将是 https://api.example.com/v2/public/tickers ( api.example.com 替换为实际交易所的 API 地址)。

请求方法： 访问端点时，需要指定 HTTP 请求方法，例如 GET、POST、PUT、DELETE 等。获取交易对信息通常使用 GET 方法，因为它用于检索数据而不修改服务器上的任何内容。

请求参数： 有些端点需要请求参数才能正确执行或返回所需的数据。这些参数可以添加到 URL 中（作为查询字符串），也可以在请求正文中（通常用于 POST 请求）。例如，你可能需要传递一个交易对的符号（例如 BTCUSDT ）作为参数来获取该特定交易对的信息。

响应格式： API 端点通常以 JSON 或 XML 格式返回数据。JSON 是一种常用的轻量级数据交换格式，易于解析和处理。你需要编写代码来解析 API 响应并提取所需的信息。

示例： 为了获取所有交易对的信息，你可能需要向 /v2/public/tickers 端点发送一个 GET 请求。响应将是一个 JSON 数组，其中包含每个交易对的信息，例如价格、交易量、最高价、最低价等。为了获取特定交易对（例如 BTCUSDT）的信息，你可能需要使用 /v2/public/tickers?symbol=BTCUSDT 这样的端点，其中 symbol=BTCUSDT 是一个查询字符串参数。

构造完整的 API URL

在与加密货币交易所或其他服务进行API交互时，构建正确的URL至关重要。一个完整的API URL通常由两部分组成：基础URL（base_url）和端点（endpoint）。

url = base_url + endpoint

基础URL (base_url): 这是API提供商提供的根URL，它指向API的服务器地址。例如，Coinbase API的基础URL可能是 https://api.coinbase.com/v2/ 。请注意，不同的API版本可能有不同的基础URL，确保使用正确的版本。

端点 (endpoint): 端点是API中特定的功能或资源的路径。它附加在基础URL之后，用于指定你要访问的具体功能。例如，要获取比特币的价格，端点可能是 /prices/BTC-USD 。结合基础URL和端点，完整的URL可能是 https://api.coinbase.com/v2/prices/BTC-USD 。

在实际应用中，你可能需要根据API文档中的说明，在URL中添加查询参数（query parameters）来进一步指定请求的条件。查询参数通常以问号（?）开始，并以键值对的形式出现，例如 ?currency=USD&granularity=60 。完整的URL可能如下所示： https://api.example.com/data?currency=USD&granularity=60 。 不同的API对于参数的格式要求不同，因此需要仔细阅读官方文档。

构建完整的URL时，请务必参考API提供商的官方文档，以确保URL的正确性和有效性。错误的URL可能会导致请求失败或返回错误的数据。

发送 GET 请求

在与加密货币交易所或API交互时，发送GET请求是一种常见的操作，用于获取信息，例如市场数据、账户余额等。为了保证请求的安全性和身份验证，通常需要在请求头中包含特定的认证信息。

以下展示了如何构造带有必要头部信息的GET请求，其中涉及API密钥、时间戳和签名： 

headers = {
    "X-BAPI-API-KEY": api_key,
    "X-BAPI-TIMESTAMP": str(int(time.time())),
    "X-BAPI-SIGN": generate_signature(api_secret, "GET", endpoint, {})  # generate_signature 函数需要自行实现，用于生成签名
}

头部信息详解：

  • X-BAPI-API-KEY: 这是你的API密钥，用于标识你的身份。请从你的交易所账户或API提供商处获取此密钥，并妥善保管，切勿泄露。
  • X-BAPI-TIMESTAMP: 这是一个时间戳，通常以Unix时间（自1970年1月1日午夜以来的秒数）表示。用于防止重放攻击，确保请求的时效性。使用 time.time() 函数获取当前时间，并将其转换为整数形式的字符串。
  • X-BAPI-SIGN: 这是请求的签名，用于验证请求的完整性和真实性。生成签名通常涉及使用你的API密钥和API密钥的密钥（api_secret）对请求的某些部分（如请求方法、端点、参数等）进行哈希处理。 generate_signature 函数需要根据API提供商的要求自行实现。

请求发送：

使用Python的 requests 库发送GET请求。将构建好的头部信息传递给 headers 参数。 

response = requests.get(url, headers=headers)

其中， url 是要请求的API端点地址。 response 对象包含了服务器的响应，你可以从中提取所需的数据。

关于 generate_signature 函数：

generate_signature 函数的具体实现取决于目标API的要求。通常，它涉及以下步骤：

  1. 将请求方法（如"GET"）、端点（ endpoint ）和请求参数（此处为空字典 {} ，如果GET请求也需要传递参数，则需要将参数包含在内）按照特定规则进行组合。
  2. 使用API密钥的密钥（ api_secret ）对组合后的字符串进行哈希运算（通常使用HMAC-SHA256算法）。
  3. 将哈希结果转换为字符串，并根据API的要求进行编码（如Base64编码）。

请务必参考API的官方文档，了解签名生成的确切步骤和要求，并据此实现 generate_signature 函数。

注意事项：

  • 确保你的API密钥和密钥安全存储，避免泄露。
  • 仔细阅读API文档，了解每个API端点的具体要求和参数。
  • 处理API响应时，注意检查状态码和错误信息，以便及时发现和解决问题。

检查响应状态码

HTTP 响应状态码是服务器向客户端（如浏览器或应用程序）发送的数字代码，用于指示请求是否成功。 200 OK 状态码表示请求已成功处理。因此，检查状态码是确保 API 调用成功的关键一步。

if response.status_code == 200:

当状态码为 200 时，表示请求成功，可以进一步处理响应数据。 此时，获取响应头信息至关重要，因为响应头包含了关于响应本身的元数据，例如内容类型、内容长度以及重要的速率限制信息。 


# 获取响应头信息
headers = response.headers

# 提取速率限制信息
# 许多 API 为了防止滥用，实施了速率限制。
# 这些限制通常通过 HTTP 响应头中的特定字段来传达。
#  X-RateLimit-Limit：在特定时间窗口内允许的最大请求数。
# X-RateLimit-Remaining：在当前时间窗口内剩余的请求数。
# X-RateLimit-Reset：一个 Unix 时间戳，指示速率限制重置的时间。
limit  = headers.get("X-RateLimit-Limit")
remaining = headers.get("X-RateLimit-Remaining")
reset  = headers.get("X-RateLimit-Reset")

# 打印速率限制信息，便于监控和调试
print(f"Rate Limit: {limit}")
print(f"Remaining: {remaining}")
print(f"Reset Time: {reset}")

# 处理 API 响应数据
# 根据 API 返回的数据类型，选择合适的解析方法。
# 常见的 API 返回数据类型包括 JSON 和 XML。
# 这里假设 API 返回 JSON 数据。
data =  response.()
print(.dumps(data, indent=4))

在成功获取和解析响应数据后，就可以根据应用程序的需要使用这些数据。 例如，可以将数据存储到数据库中，或者将其显示在用户界面上。

else:

如果状态码不是 200 ，则表示请求失败。 常见的失败状态码包括 400 Bad Request （表示客户端发送的请求无效）、 401 Unauthorized （表示客户端未经过身份验证）和 500 Internal Server Error （表示服务器遇到了内部错误）。 处理错误状态码对于确保应用程序的健壮性至关重要。

print(f"API 请求失败，状态码: {response.status_code}")

print(response.text)

除了打印状态码之外，还应该打印响应的文本内容，因为文本内容通常包含关于错误的更多详细信息。 这些信息可以帮助你诊断和解决问题。

注意: 上述代码示例中， generate_signature 函数需要你自己根据 Bybit API 文档实现，用于生成 API 请求的签名。

2. 通过 Bybit 官方 API 文档

Bybit 官方 API 文档是了解其 API 速率限制最权威的来源。 文档会针对每个 API 接口，详细阐述请求频率限制、时间窗口、以及超出限制后的处理方式。 在开发任何基于 Bybit API 的应用程序之前，必须仔细查阅相关 API 接口的文档。理解速率限制规则，例如每分钟或每秒允许的请求数量，对于避免 API 调用失败至关重要。 文档通常包括示例代码，展示了如何正确处理速率限制错误。 为了确保应用程序的稳定性和可靠性，开发者应实施适当的错误处理机制，以便在达到速率限制时进行重试或采取其他补救措施。 Bybit 可能会根据市场条件或系统负载调整 API 速率限制，因此定期查阅官方文档是保持应用程序兼容性的关键。

3. 通过 Bybit 账户管理界面查看 API 使用情况

Bybit 及其他加密货币交易所，为方便用户监控其 API 密钥的使用情况，有时会在用户账户管理界面提供API相关的统计信息。这些信息通常包含API调用次数、剩余可调用次数以及其他与 API 密钥活动相关的指标。用户可以通过以下步骤进行查看：

  1. 登录您的 Bybit 账户： 使用您的用户名和密码，安全地登录到 Bybit 交易所的官方网站或应用程序。
  2. 导航至账户管理或 API 管理区域： 登录后，寻找“账户”、“设置”、“API 管理”或类似的选项。这些选项通常位于用户资料设置、安全设置或 API 密钥管理区域。
  3. 查找 API 使用情况统计信息： 在 API 管理区域，查看是否有显示 API 使用情况的统计信息。这些信息可能以表格、图表或其他可视化形式呈现，展示了您在特定时间段内的 API 调用活动。
  4. 解读统计信息： 仔细阅读并理解所提供的统计信息。重点关注以下关键指标：
    • 已调用次数： 显示您已使用的 API 调用总数。
    • 剩余可调用次数： 显示您在当前 API 速率限制周期内剩余的 API 调用次数。

尽管通过账户管理界面查看 API 使用情况可能不如直接解析 HTTP 响应头信息那样提供实时的、细粒度的信息，但它能够提供一个宏观的 API 使用情况概览，帮助您监控您的 API 密钥活动，并在接近 API 速率限制时及时采取措施。请注意，Bybit 可能不会在所有情况下都提供详细的 API 使用情况统计信息，具体取决于其平台的设计和功能更新。

4. 使用 API 监控工具

为了确保您的加密货币交易API的稳定性和性能，利用专门的API监控工具至关重要。这些工具能够提供实时的数据分析和可视化的界面，帮助您深入了解API的使用情况和潜在问题。它们不仅仅是简单的监控，更是提供洞察力的平台，帮助您优化API性能，降低风险。

这些API监控工具通常具备以下关键功能：

  • HTTP 响应头解析： 自动解析 HTTP 响应头，提取关键信息如状态码、内容类型、服务器信息等。通过分析这些信息，您可以快速识别API的性能瓶颈和潜在错误。例如，大量的5xx错误可能指示服务器端存在问题，而延迟的响应时间则可能表明需要优化API的查询或数据处理效率。
  • 图形化展示： 将收集到的数据以图形化的方式呈现，例如折线图、柱状图和热力图。这些可视化图表能够直观地展示 API 的调用量、响应时间、错误率等关键指标，便于快速识别异常模式和趋势。
  • 实时告警： 配置告警规则，当 API 的性能指标超出预设阈值时，例如响应时间超过可接受的范围或错误率显著上升时，立即发送通知。这使得您可以及时发现并解决问题，防止对用户体验和业务运营造成影响。
  • 历史数据分析： 存储API的历史调用数据，并提供分析功能，以便您追踪API的性能趋势，识别长期存在的问题，并评估优化措施的效果。通过对历史数据的分析，您可以更好地了解 API 的运行状况，并制定相应的优化策略。
  • 自定义监控指标： 除了标准的 HTTP 响应头信息，许多工具还允许您自定义监控指标，例如特定业务数据的处理时间或特定功能的调用次数。这使得您可以根据自己的业务需求，更全面地监控 API 的性能。

通过使用API监控工具，您可以更有效地监控加密货币交易 API 的调用情况，及时发现潜在的问题，并采取相应的措施进行优化，从而确保API的稳定性和性能，为您的业务提供可靠的技术支持。选择适合您需求的API监控工具，将有助于您提升开发效率，降低运营风险，并为用户提供更好的体验。

处理超出速率限制的情况

如果你的 API 请求超出了 Bybit 交易所设定的速率限制，Bybit 服务器将会返回一个错误响应，通常 HTTP 状态码为 429 Too Many Requests 。这意味着你在指定的时间窗口内发送了过多的请求。遇到这种情况，应立即采取以下措施，以避免 IP 地址被暂时或永久屏蔽：

  1. 立即暂停发送请求： 立即停止向 Bybit API 发送任何新的请求。过度请求会加剧问题，导致更长时间的限制。
  2. 确定并等待时间窗口重置： Bybit API 响应头中通常会包含 X-RateLimit-Reset 字段。该字段提供了一个 Unix 时间戳，表示当前速率限制窗口重置的时间。记录该时间，并等待直至该时间戳对应的时间点再发送请求。部分 API 可能还会返回关于剩余请求数量的 header，例如 X-RateLimit-Remaining ，可用于更精细的控制请求频率。
  3. 调整请求发送频率： 在恢复发送请求后，显著降低请求发送的频率。分析你的代码，确保请求发送的间隔足够长，以避免再次触发速率限制。实现一个 backoff 机制，在遇到 429 错误时，指数级地增加请求之间的延迟。
  4. 优化 API 调用逻辑： 仔细检查你的 API 调用逻辑，识别并消除不必要的请求。例如，检查是否有重复的或冗余的 API 调用。考虑以下优化策略：
    • 数据缓存： 对于不经常变化的数据，实施缓存机制。将数据存储在本地缓存中，避免每次都向 API 发送请求。
    • 批量请求： Bybit API 可能支持批量请求。将多个小的请求合并成一个大的请求，以减少 API 调用的总次数。
    • 增量更新： 只请求自上次请求后发生变化的数据，而不是每次都请求完整的数据集。
  5. 考虑使用 WebSocket API： 对于需要实时更新的应用场景，强烈建议使用 Bybit 提供的 WebSocket API。WebSocket 允许建立一个持久的双向通信连接，通过此连接可以实时接收市场数据和账户更新，避免了频繁轮询 API 带来的速率限制问题。WebSocket 提供了更高效、更低延迟的数据获取方式。
  6. 联系 Bybit 客服： 如果你确信你的 API 密钥需要更高的速率限制，或者你是机构用户，可以联系 Bybit 客服，说明你的用例和需求，并申请提升 API 速率限制。请提供充分的理由，以便客服能够更好地评估你的申请。
总结来说， 了解并监控 Bybit API 的调用次数限制对于高效使用 Bybit API 至关重要。 通过解析 HTTP 响应头信息，查阅官方文档，使用 API 监控工具等方法，你可以实时监控 API 的调用情况，并采取相应的措施，避免因超出限制而导致 API 请求失败。