> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# スロットリングのベスト プラクティス

> Retry-After ヘッダー、リクエストのバッチ処理、レート緩和戦略を活用して、PlayFab の HTTP 429 スロットリング応答を処理し、API トラフィックを制限内に収めます。

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

ヘッダーの例:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 8
```

レスポンス ボディの例:

```json theme={null}
{ 
  "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](/services/playfab/sdks/c) を利用している場合、SDK は呼び出し側に代わって再試行の処理を試みます。それ以外の場合は、retry の値と以下の戦略を使ってカスタム処理を開発してください。

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

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

1. リクエスト レートの見直し
   * 大量のリクエストを送信している理由を分析します。
   * API の対象となる特定のプレイヤーまたはタイトル エンティティに対するリクエスト レートを下げる方法を評価します。

2. API 呼び出しのバッチ処理
   * API 呼び出しをバッチ処理して頻度を下げます。
   * 例: プロファイル更新を毎秒行うのではなく、10 秒ごとにバッチ処理します。

## 重要ポイント

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

## 関連項目

* [Economy v2 の制限](/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [PlayFab におけるスロットリング](/ja-jp/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [RTA サービスのベスト プラクティス](/ja-jp/services/xbox-services/fundamentals/rta/concepts/live-rta-best-practices.md)
- [XBOX services 呼び出しのベストプラクティス](/ja-jp/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)
- [モダン ゲーマータグのベスト プラクティスとテスト](/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Insights のベスト プラクティス](/ja-jp/services/playfab/data-analytics/legacy/insights/best-practices.md)