スロットリングのベストプラクティス - XBOX Game Development Documentation

PlayFab でスロットリングが発生すると、HTTP 429 エラーが返され、API 呼び出しがスロットリングされていることを示します。レスポンスのヘッダーとボディには、エラーを理解するための重要な情報が含まれます。ヘッダーの例:

HTTP/1.1 429 Too Many Requests
Retry-After: 8

レスポンスボディの例:

{ 
  "code": 429, 
  "status": "TooManyRequests", 
  "retryAfterSeconds": 8, 
  "error": "APIClientRequestRateLimitExceeded", 
  "errorCode": 1199, 
  "errorMessage": "The client has exceeded the maximum API request rate and is being throttled" 
} 

「Retry-After」 および 「retryAfterSeconds」 プロパティは、スロットリングを回避するために別のリクエストを試行するまでの待機時間 (秒) を示します。最新のクロスプラットフォーム C/C++ SDK を利用している場合、SDK は呼び出し側に代わって再試行の処理を試みます。それ以外の場合は、retry の値と以下の戦略を使ってカスタム処理を開発してください。

スロットリング問題の緩和

スロットリングエラーが継続する場合は、次の戦略の採用を検討してください:

リクエストレートの見直し
- 大量のリクエストを送信している理由を分析します。
- API の対象となる特定のプレイヤーまたはタイトルエンティティに対するリクエストレートを下げる方法を評価します。
API 呼び出しのバッチ処理
- API 呼び出しをバッチ処理して頻度を下げます。
- 例: プロファイル更新を毎秒行うのではなく、10 秒ごとにバッチ処理します。

重要ポイント

スロットリングエラーは HTTP 429 応答をもたらし、エラーの性質に関する詳細が含まれます。
Retry-After および 「retryAfterSeconds」 プロパティを利用して、次のリクエストまでの待機時間を決定します。
高頻度のリクエストが必要かどうかを評価し、適切に最適化します。
バッチ処理戦略を実装してスロットリングの懸念を軽減し、システム全体の効率を高めます。

関連項目

Economy v2 の制限

最終更新日 2026年8月13日

関連トピック

PlayFab におけるスロットリング RTA サービスのベストプラクティス XBOX services 呼び出しのベストプラクティスモダンゲーマータグのベストプラクティスとテスト Insights のベストプラクティス

⌘I