Pular para o conteúdo principal
Este tutorial mostra como acessar, reconhecer e tratar erros de API usando o SDK do PlayFab. As práticas descritas aqui se aplicam igualmente aos SDKs de administrador, servidor e cliente, mas os padrões dependem muito da linguagem escolhida. Em resumo, o padrão escolhido será válido para qualquer SDK (administrador/servidor/cliente), mas os detalhes de implementação serão específicos da sua linguagem de programação e do seu ambiente.

Capturar e acessar o erro

Os SDKs do PlayFab geralmente relatam erros retornando um objeto de erro. O trecho a seguir mostra como detectar e acessar o erro.
Em geral, se um objeto de erro estiver definido (não for nulo), isso indica que ocorreu um erro. Em seguida, podemos inspecionar o erro mais detalhadamente.

Inspecionar o erro

A forma mais comum de inspecionar um erro é reconhecê-lo pelo código. Conforme descrito em Códigos de erro de métodos da API global, cada erro gerado contém códigos de erro legíveis e numéricos.
O código por si só é suficiente para reconhecer e processar o erro adequadamente.
Vamos usar o método de API LoginWithEmailAddress como exemplo. Conforme indicado na documentação desse método, os seguintes erros internos podem ser gerados durante a execução:
  • InvalidTitleId 1004
  • AccountNotFound 1001
  • InvalidEmailOrPassword 1142
  • RequestViewConstraintParamsNotAllowed 1303
O método a seguir ilustra como inspecionar e reconhecer esse tipo de erro.

Tratar o erro

Depois que o erro for identificado, a estratégia de tratamento/recuperação dependerá do tipo e da natureza do erro. Erros como argumentos inválidos nunca terão êxito se forem repetidos. A solicitação precisa ser corrigida para que essa chamada de API tenha êxito. Há um subconjunto de erros em que uma estratégia de repetição pode ser aplicada. Os tipos de erro que podem ser repetidos estão descritos em Códigos de erro de métodos da API global. Verifique se você atende aos seguintes requisitos ao aplicar uma estratégia de repetição:
  • A cada nova tentativa, o atraso entre as tentativas deve aumentar exponencialmente. Isso aumenta suas chances de uma chamada bem-sucedida e impede que seu jogo sobrecarregue o servidor do PlayFab (o que resultará em mais chamadas rejeitadas).
  • Você deve aplicar essa estratégia de repetição de forma seletiva, usando-a apenas para os códigos que valem a pena repetir.
Consulte nosso tutorial Códigos de erro de métodos da API global para obter uma lista de códigos que podem ser repetidos com segurança.
Última modificação em 8 de outubro de 2026