Tratamento de erros de resgate do marketplace

Ao trabalhar com APIs de resgate do marketplace, é fundamental ter um tratamento de erros robusto. Este artigo explora as práticas recomendadas para tratar erros, desde a compreensão dos códigos de erro comuns até a implementação de estratégias de recuperação de erros adequadas. Os erros são retornados usando o PlayFab Error Wrapper padrão

APIErrorWrapper

O APIErrorWrapper é um wrapper em torno de cada resposta de API com falha.

Nome	Tipo	Descrição
code	integer	Código HTTP numérico.
error	string	Código de erro do PlayFab.
errorCode	integer	Código de erro numérico do PlayFab.
errorDetails	object	Descrição detalhada de problemas individuais com o objeto da solicitação.
errorMessage	string	Descrição do errorCode do PlayFab.
status	string	Código HTTP em cadeia de caracteres.

Para quaisquer problemas relacionados ao marketplace, retornamos um par chave-valor (KVP) no objeto errorDetails.

Nome	Tipo	Descrição
MarketplaceErrorCode	string[]	O código de erro retornado pelo marketplace se uma chamada ao marketplace falhar. A primeira cadeia de caracteres na matriz será o código de erro. A segunda cadeia de caracteres será a mensagem de erro, se estiver disponível.

Trata-se de um repasse do código de erro e da mensagem do código de erro retornados pelo marketplace.

A resposta de erro aparecerá conforme mostrado abaixo. Os desenvolvedores devem verificar se wrapper.errorDetails['MarketplaceErrorCode'] não é nulo e, em seguida, analisar o primeiro elemento para tratar os diferentes códigos de erro do marketplace adequadamente.

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

Códigos de status HTTP de falha públicos

Esta seção lista os códigos de erro retornados pelas APIs de resgate.

400 - Bad Request
- Todas as falhas de validação de solicitação e de entrada GenericErroCodes.InvalidRequest
- Todas as falhas de validação de configuração GenericErrorCodes.InvalidServiceConfiguration
- Todas as falhas de autorização do marketplace
  - GenericErrorCodes.InvalidServiceConfiguration - Relacionado a falhas de identidade do serviço.
  - GenericErrorCodes.InvalidAuthToken - Relacionado a falhas de identidade do jogador.
- Todas as falhas de configuração de itens do catálogo GenericErrorCodes.InvalidCatalogItemConfiguration
401/403 - Not Authorized/Forbidden
- Falhas de autorização do PlayFab GenericErrorCodes.NotAuthorized
503 - MarketplaceUnavailable
- GenericErrorCodes.DownstreamServiceUnavailable

XBOX Services

PlayFab

Tratamento de erros do marketplace

Tratamento de erros de resgate do marketplace

APIErrorWrapper

Códigos de status HTTP de falha públicos

​Tratamento de erros de resgate do marketplace

​APIErrorWrapper

​Códigos de status HTTP de falha públicos

Tratamento de erros de resgate do marketplace

APIErrorWrapper

Códigos de status HTTP de falha públicos