速率限制和配额 — WhatsApp 个人资料 API

各层级的月度配额

每秒突发次数限制

每层级的突发次数限制可以防止单个密钥被滥用：

MEGA 用户如果需要持续更高的突发流量，可以通过专属客户经理申请自定义限额。

速率限制标头

每个响应都包含小写字母的标头（RapidAPI 约定），用于跟踪每月配额：

x-ratelimit-requests-limit:     60000
x-ratelimit-requests-remaining: 59999
x-ratelimit-requests-reset:     2591983   # seconds until reset

429 请求过多

突发限制违规（请求过于密集）将返回 HTTP 429 错误，错误信息较短：

HTTP/1.1 429 Too Many Requests

{
  "error": "Requests must be at least 0.5 seconds apart"
}

0.5 秒的间隔时间反映了大多数套餐的默认最小间隔秒数（= 2 个请求/秒）。请查看 /api-key-stats → roleInfo.minIntervalSeconds 以获取您套餐的确切值。

检查您的配额

代理服务器公开了 GET /api-key-stats 请求——随时调用该请求即可读取实时计数器：

{
  "key": "08dc53d3-...",
  "role": "pro_60",
  "status": "active",
  "requestLimit": 60000,
  "requestRemaining": 59999,
  "requestReset": 2591982,
  "resetAt": "2026-05-27T02:24:56.708Z",
  "expiresAt": "2026-05-27T02:24:56.708Z",
  "lastUsedAt": "2026-04-27T02:25:12.955Z",
  "requestCountMonth": 1,
  "maxMonthlyUsage": 60000,
  "roleInfo": {
    "name": "pro_60",
    "maxMonthlyUsage": 60000,
    "minIntervalSeconds": 0.5
  }
}

缓存策略

用户资料数据在服务器端缓存。在缓存窗口期内对同一号码的重复查找将从缓存中获取数据。要强制执行新的查找，请在 `/number/{number}` 后附加 `?forceBypassCache=1`——新的请求仍会占用配额。

有关的