Passer au contenu principal
Ce tutoriel montre comment accéder aux erreurs d’API, les reconnaître et les gérer à l’aide du SDK PlayFab. Les pratiques décrites ici s’appliquent aussi bien aux SDK Admin, Server et Client, mais les modèles dépendent fortement du langage que vous choisissez. En résumé, le modèle que vous choisissez sera valable pour n’importe quel SDK (Admin/Server/Client), mais les détails d’implémentation seront propres à votre langage de programmation et à votre environnement.

Interception de l’erreur et accès à celle-ci

Les SDK PlayFab signalent généralement les erreurs en renvoyant un objet d’erreur. L’extrait suivant montre comment détecter l’erreur et y accéder.
En général, si un objet d’erreur est défini (non null), cela indique qu’une erreur s’est produite. Nous pouvons alors examiner l’erreur plus en détail.

Examen de l’erreur

La façon la plus courante d’examiner une erreur consiste à la reconnaître grâce à son code. Comme décrit dans Codes d’erreur globaux des méthodes d’API, chaque erreur générée contient des codes d’erreur lisibles et numériques.
Le code suffit à lui seul pour reconnaître l’erreur et la traiter en conséquence.
Prenons comme exemple la méthode d’API LoginWithEmailAddress. Comme l’indique la documentation de cette méthode, les erreurs internes suivantes peuvent être levées lors de l’exécution :
  • InvalidTitleId 1004
  • AccountNotFound 1001
  • InvalidEmailOrPassword 1142
  • RequestViewConstraintParamsNotAllowed 1303
La méthode suivante montre comment examiner et reconnaître une telle erreur.

Gestion de l’erreur

Une fois l’erreur identifiée, la stratégie de gestion/récupération dépend du type et de la nature de l’erreur. Les erreurs telles que les arguments non valides n’aboutiront jamais en cas de nouvelle tentative. La requête doit être corrigée pour que cet appel d’API réussisse. Il existe un sous-ensemble d’erreurs pour lesquelles une stratégie de nouvelle tentative peut être appliquée. Les types d’erreurs pouvant faire l’objet d’une nouvelle tentative sont décrits dans Codes d’erreur globaux des méthodes d’API. Veillez à respecter les exigences suivantes lorsque vous appliquez une stratégie de nouvelle tentative :
  • À chaque nouvelle tentative, le délai entre les tentatives doit augmenter de manière exponentielle. Cela augmente vos chances de réussite de l’appel et évite que votre jeu ne submerge le serveur PlayFab (ce qui entraînerait davantage d’appels rejetés).
  • Vous devez appliquer cette stratégie de nouvelle tentative de manière sélective, uniquement pour les codes qui justifient une nouvelle tentative.
Consultez notre tutoriel Codes d’erreur globaux des méthodes d’API pour obtenir la liste des codes pour lesquels une nouvelle tentative est sûre.
Dernière modification le 8 octobre 2026