Gestion des erreurs d’échange sur les places de marché

Lorsque vous travaillez avec les API d’échange sur les places de marché, il est essentiel d’avoir une gestion des erreurs robuste. Cet article explore les pratiques exemplaires de gestion des erreurs, de la compréhension des codes d’erreur courants jusqu’à la mise en œuvre de stratégies de récupération des erreurs en douceur. Les erreurs sont retournées au moyen du wrapper d’erreur PlayFab standard

APIErrorWrapper

APIErrorWrapper est un wrapper qui enveloppe chaque réponse d’API ayant échoué.

Nom	Type	Description
code	integer	Code HTTP numérique.
error	string	Code d’erreur PlayFab.
errorCode	integer	Code d’erreur PlayFab numérique.
errorDetails	object	Description détaillée des problèmes individuels liés à l’objet de la requête.
errorMessage	string	Description du errorCode PlayFab.
status	string	Code HTTP sous forme de chaîne.

Pour tout problème lié aux places de marché, nous retournons une paire clé-valeur (KVP) dans l’objet errorDetails.

Nom	Type	Description
MarketplaceErrorCode	string[]	Le code d’erreur retourné par la place de marché si un appel à celle-ci a échoué. La première chaîne du tableau est le code d’erreur. La deuxième chaîne est le message d’erreur, s’il est disponible.

Il s’agit d’un transfert direct du code d’erreur et du message du code d’erreur retournés par la place de marché.

La réponse d’erreur s’affiche comme illustré ci-dessous. Les développeurs doivent vérifier que wrapper.errorDetails['MarketplaceErrorCode'] n’est pas nul, puis analyser le premier élément pour gérer les différents codes d’erreur de la place de marché en conséquence.

"{
    "code":503,
    "errorDetails":
    {
        "MarketplaceErrorCode":["1234","sample error code"]
    },
    ...    
}"

Codes d’état HTTP d’échec publics

Cette section énumère les codes d’erreur retournés par les API d’échange.

400 - Bad Request
- Tous les échecs de validation des requêtes et des entrées GenericErroCodes.InvalidRequest
- Tous les échecs de validation de la configuration GenericErrorCodes.InvalidServiceConfiguration
- Tous les échecs d’autorisation auprès de la place de marché
  - GenericErrorCodes.InvalidServiceConfiguration - Liés aux échecs d’identité du service.
  - GenericErrorCodes.InvalidAuthToken - Liés aux échecs d’identité du joueur.
- Tous les échecs de configuration des articles du catalogue GenericErrorCodes.InvalidCatalogItemConfiguration
401/403 - Not Authorized/Forbidden
- Échecs d’autorisation PlayFab GenericErrorCodes.NotAuthorized
503 - MarketplaceUnavailable
- GenericErrorCodes.DownstreamServiceUnavailable

XBOX Services

PlayFab

Gestion des erreurs des places de marché

Gestion des erreurs d’échange sur les places de marché

APIErrorWrapper

Codes d’état HTTP d’échec publics

​Gestion des erreurs d’échange sur les places de marché

​APIErrorWrapper

​Codes d’état HTTP d’échec publics

Gestion des erreurs d’échange sur les places de marché

APIErrorWrapper

Codes d’état HTTP d’échec publics