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