Passer au contenu principal
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 :
Exemple de corps de réponse :
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, 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 (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

Dernière modification le 8 octobre 2026