Control de errores de canje del marketplace

Al trabajar con las API de canje del marketplace, es fundamental contar con un control de errores sólido. En este artículo se exploran los procedimientos recomendados para controlar errores, desde comprender los códigos de error comunes hasta implementar estrategias de recuperación de errores correctas. Los errores se devuelven mediante el contenedor de errores estándar de PlayFab

APIErrorWrapper

APIErrorWrapper es un contenedor que envuelve todas las respuestas de API con error.

Nombre	Tipo	Descripción
code	integer	Código HTTP numérico.
error	string	Código de error de PlayFab.
errorCode	integer	Código de error numérico de PlayFab.
errorDetails	object	Descripción detallada de los problemas individuales con el objeto de solicitud.
errorMessage	string	Descripción del errorCode de PlayFab.
status	string	Código HTTP en formato de cadena.

Para cualquier problema relacionado con el marketplace, se devuelve un par clave-valor (KVP) en el objeto errorDetails.

Nombre	Tipo	Descripción
MarketplaceErrorCode	string[]	El código de error devuelto por el marketplace si una llamada al marketplace produjo un error. La primera cadena de la matriz será el código de error. La segunda cadena será el mensaje de error, si está disponible.

Se trata de un paso directo del código de error y del mensaje del código de error devueltos por el marketplace.

La respuesta de error aparecerá como se muestra a continuación. Los desarrolladores deben comprobar que wrapper.errorDetails['MarketplaceErrorCode'] no sea null y, a continuación, analizar el primer elemento para controlar los distintos códigos de error del marketplace según corresponda.

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

Códigos de estado HTTP de error públicos

En esta sección se enumeran los códigos de error devueltos por las API de canje.

400 - Bad Request
- Todos los errores de validación de solicitudes y entradas GenericErroCodes.InvalidRequest
- Todos los errores de validación de configuración GenericErrorCodes.InvalidServiceConfiguration
- Todos los errores de autorización del marketplace
  - GenericErrorCodes.InvalidServiceConfiguration - Relacionado con errores de identidad del servicio.
  - GenericErrorCodes.InvalidAuthToken - Relacionado con errores de identidad del jugador.
- Todos los errores de configuración de artículos del catálogo GenericErrorCodes.InvalidCatalogItemConfiguration
401/403 - Not Authorized/Forbidden
- Errores de autorización de PlayFab GenericErrorCodes.NotAuthorized
503 - MarketplaceUnavailable
- GenericErrorCodes.DownstreamServiceUnavailable

XBOX Services

PlayFab

Control de errores del marketplace

Control de errores de canje del marketplace

APIErrorWrapper

Códigos de estado HTTP de error públicos

​Control de errores de canje del marketplace

​APIErrorWrapper

​Códigos de estado HTTP de error públicos

Control de errores de canje del marketplace

APIErrorWrapper

Códigos de estado HTTP de error públicos