コンテンツにスキップ
Documentation

RTCのレート制限

RTC は、一定時間枠内で受け付けるリクエスト数に制限APIを設けています。この制限は、 1つの暴走したクライアントからすべての顧客のルームを保護するためのものであり、 課金メーターではありません。

制限カウント目的
IPアドレスごとに1つのアドレスからのリクエストはすべて、ログインの有無にかかわらず不正利用防止対策;最下層
キーAPIごとに1つのプロジェクトAPIキーを使用して行われるリクエストこれにより、1つの統合や漏洩したキーによって他の統合がリソース不足に陥るのを防ぎます
組織ごと1つのRTC組織におけるすべてのキーのリクエストおよびコンソールセッション顧客間で公平にリソースを分配してください

リクエストは、適用されるすべての制限を満たす必要があります。キーごとおよび 組織ごとの制限はご利用のプランによって異なり、組織ごとに 調整CHAMPREPすることができます。数値をハードコーディングするのではなく、以下のヘッダーをご確認ください。

一部の操作には、特定の コードで応答する、より厳格な制限が設けられています。例えば、Webhookの再送信(REPLAY_QUOTA) およびルーム内のアプリメッセージ(MESSAGE_RATE_LIMITED).

認証済みレスポンスには、適用される最も厳しい制限の状態が含まれます:

ヘッダー意味
X-RateLimit-Limit現在のウィンドウで許可されているリクエスト
X-RateLimit-Remaining現在のウィンドウに残っているリクエスト
X-RateLimit-Resetウィンドウがリセットされるまでの秒数

制限を超えるリクエストに対しては、 429 コードと共に RATE_LIMITED および a Retry-After ヘッダーを、 秒単位で指定してください。

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
X-Error-Code: RATE_LIMITED
X-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21

上記の数値はあくまで一例です。

適切なバックオフを行ってください

Section titled “適切なバックオフを行ってください”
  • On 429、少なくとも Retry-After 次のリクエストの前に数秒間待機し、その後 徐々に処理を再開してください。短いループ内で再試行を行わないでください。
  • 定期的な処理(ポーリング、レコンシリエーション)は時間をかけて分散させ、 webhooks ポーリングに代えて。
  • 統合ごとに1つのキーAPIを使用してください。そうすれば、そのキーに固有の制限が設定されるため、 暴走したジョブをその範囲内に収めることができ、他のキーに影響を与えることなく、1つのキーのみを無効化できます。
  • 参加者の認証情報は、ユーザーが実際に参加した時点で発行し、事前に発行しないでください。 参加数が非常に多い場合は、 オフラインで参加トークンを発行する プロジェクトの 署名キーを使用して発行してください。
  • を使用してください ?limit および ?cursor リスト全体を再リクエストする代わりに、リストをページ単位で 閲覧できます。