レート制限と割り当て — 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秒間隔という表現は、ほとんどのプランにおけるデフォルトのminIntervalSeconds（= 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 を追加してください。ただし、この新しいリクエストも割り当て量にカウントされます。

関連している