> ## 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.

# Bonnes pratiques en matière de limitation

> Gérez les réponses de limitation HTTP 429 de PlayFab à l'aide des en-têtes Retry-After, du regroupement des requêtes et de stratégies d'atténuation du débit pour maintenir le trafic d'API dans les limites.

Lorsque vous êtes confronté à une limitation (throttling) dans PlayFab, PlayFab renvoie une erreur HTTP 429, signalant qu'un appel d'API est limité. L'en-tête et le corps de la réponse contiennent des informations clés pour comprendre l'erreur.

Exemple d'en-tête :

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

Exemple de corps de réponse :

```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" 
} 
```

Les propriétés **"Retry-After** et **"retryAfterSeconds"** indiquent le délai d'attente, en secondes, avant de tenter une nouvelle requête afin d'éviter la limitation. Si vous utilisez le dernier [SDK C/C++ multiplateforme](/fr/services/playfab/sdks/c/index), le SDK tente de gérer la nouvelle tentative pour le compte de l'appelant. Sinon, utilisez les stratégies ci-dessous avec les valeurs de nouvelle tentative pour développer une gestion personnalisée.

## Atténuation des problèmes de limitation

Si les erreurs de limitation persistent, envisagez d'adopter les stratégies suivantes :

1. Examiner le débit des requêtes
   * Analysez pourquoi vous envoyez un volume élevé de requêtes.
   * Évaluez les moyens de réduire le débit des requêtes pour les entités de joueur ou de titre spécifiques ciblées par l'API.
   * Pour voir quelles API et quels appelants approchent ou atteignent une limite, consultez l'événement [api\_rate\_limit\_alert](https://learn.microsoft.com/gaming/playfab/api-references/events/Title/api-rate-limit-alert) (préversion).

2. Regrouper les appels d'API
   * Réduisez la fréquence en regroupant les appels d'API.
   * Exemple : regroupez les mises à jour de profil toutes les 10 secondes au lieu de les effectuer chaque seconde.

## Points clés à retenir

* Les erreurs de limitation entraînent une réponse HTTP 429 contenant des détails sur la nature de l'erreur.
* Utilisez les propriétés **Retry-After** et **"retryAfterSeconds"** pour déterminer le délai d'attente avant d'effectuer une nouvelle requête.
* Évaluez la nécessité des requêtes à haute fréquence et optimisez en conséquence.
* Mettez en œuvre des stratégies de regroupement pour atténuer les problèmes de limitation et améliorer l'efficacité globale du système.

## Voir aussi

* [Limites d'Economy v2](/fr/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [XAG 123 : Bonnes pratiques en matière de santé mentale](/fr/build/game-principles/accessibility/xag-deep-dives/xag-123-mental-health-best-practices.md)
- [Bonnes pratiques](/fr/services/xbox-services/develop/best-practices/index.md)
- [Limitation dans PlayFab](/fr/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [Bonnes pratiques pour le service RTA](/fr/services/xbox-services/fundamentals/rta/concepts/live-rta-best-practices.md)
- [Bonnes pratiques pour appeler les services XBOX](/fr/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)