Códigos de erro globais dos métodos de API

• Code - O código de erro HTTP retornado pelo servidor
• ErrorCode - Um código de erro numérico específico do PlayFab.
• Error - Um código legível por humanos específico do PlayFab.
• ErrorMessage - Uma descrição do erro que fornece contexto adicional útil para depuração.
• ErrorDetails - Nem sempre presente. Fornece contexto adicional para determinados tipos de erros.

​

Códigos seguros para nova tentativa

• APIClientRequestRateLimitExceeded (1199): Indica chamadas demais em um curto intervalo.
• APIConcurrentRequestLimitExceeded (1342): Indica chamadas simultâneas demais.
• ConcurrentEditError (1133): Indica chamadas simultâneas demais ou chamadas sequenciais muito rápidas.
• DataUpdateRateExceeded (1287): Indica chamadas simultâneas demais ou chamadas sequenciais muito rápidas.
• DownstreamServiceUnavailable (1127): Indica que o PlayFab ou um serviço de terceiros pode estar com um problema temporário.
• ServiceUnavailable (1123): Indica que o PlayFab pode estar com um problema temporário ou que o cliente está fazendo chamadas de API demais rápido demais. Se você repetir essa solicitação, é importante usar corretamente uma estratégia de recuo exponencial.

​

Códigos que nunca devem ser repetidos

• AccountBanned (1002):
  A conta do jogador foi banida; todos os métodos de API falharão com este erro.
• AccountDeleted (1322): A conta do jogador foi excluída; todos os métodos de API falharão com este erro.
• AccountNotFound (1001): A conta do jogador não existe, provavelmente porque você não está copiando um PlayFabId/TitlePlayerId corretamente. Este erro sempre ocorrerá se o identificador não estiver correto.
• APIRequestsDisabledForTitle (1295): Todas as solicitações de API foram desabilitadas para este título, e ele não pode mais ser usado.
• InvalidContentType (1144): Deveria ser impossível receber este erro se você estiver usando um de nossos SDKs. Se você estiver fazendo suas próprias chamadas HTTPS brutas aos métodos de API do PlayFab, seu cabeçalho Content-Type deve ser application/json. Nenhum outro formato é aceito.
• InvalidEntityType (1373): O tipo de entidade no token usado para autenticação não é compatível com esta API.
• InvalidParams (1000): O objeto de solicitação de API enviado ao PlayFab tem parâmetros inválidos e não pode ser executado.
• InvalidRequest (1071): O objeto de solicitação de API enviado ao PlayFab é inválido e não pode ser executado.
• InvalidTitleId (1004): A solicitação forneceu um TitleId que não corresponde ao título fornecido na URL do método. Na maioria dos SDKs, você não deve especificar um TitleId para solicitações de login, pois isso é feito automaticamente. Na API de administração, TitleIds explícitos são um recurso de segurança Dev->Test->Live.
• NotAuthenticated (1074): O cliente tentou chamar uma API que exige autenticação por SessionTicket sem fazer login primeiro.
• NotAuthorized (1089): Credenciais incorretas ou outras entradas inválidas relacionadas ao login.
• NotAuthorizedByTitle (1191): Este método foi desabilitado pela Política de API e não pode ser chamado.
• ProfileDoesNotExist (1298): Houve uma tentativa de acessar uma entidade (jogador, personagem, título etc.) que não existe. Provavelmente um erro de digitação ou alguma entrada inválida em algum lugar.
• TitleDeleted (1347): Este título foi excluído do PlayFab e não pode mais ser usado.
• UnknownError (1039): Isso normalmente ocorre se informações inválidas forem enviadas a um complemento de terceiros e nosso servidor tiver encontrado um resultado ou erro desconhecido ao interagir com sistemas externos. Para resolver isso, experimente suas entradas e tente determinar se elas são inválidas de alguma forma. Caso contrário, relate o erro nos fóruns, com seu titleId, o JSON completo da solicitação (se possível) e a saída do erro. O Postman é uma ferramenta útil para depurar essa situação.
• InvalidAPIEndpoint (1131): Indica que a URL desta solicitação não é válida para este título.
• OverLimit (1214): Indica que uma tentativa de executar uma operação fará com que o uso do serviço ultrapasse o limite mostrado nas páginas de limites do Game Manager. Avalie os detalhes do erro retornado para determinar qual limite seria excedido.

​

Outros códigos de erro relevantes

• APIConcurrentRequestLimitExceeded (1342): Seu título está sobrecarregando o CloudScript ou está tentando forçar a avaliação de segmentos com muita frequência (ou ambos). No primeiro caso, os dois pontos a examinar são:
  1. Com que frequência suas chamadas de script usam quase o tempo máximo por chamada (ou, pior, atingem o tempo limite).
  2. Com que frequência você está chamando o CloudScript por jogador. As chamadas para obter a lista de jogadores em um segmento seriam o principal ponto a examinar (uma tarefa direcionada a um segmento também causa reavaliação, mas isso deve ser pouco frequente).
• ConnectionTimeout (2): Dependendo das especificidades do SDK que você está usando e da pilha de rede subjacente, é possível ver erros como ConnectionError, ConnectionTimeout ou outros erros relacionados a dificuldades para contatar os servidores do PlayFab. Todos eles indicam problemas de rede. A origem mais comum é uma desconexão no lado do cliente. Também é possível recebê-los quando o roteamento da internet entre o cliente e os servidores do PlayFab é interrompido por algum motivo. Há muito pouco que um jogo pode fazer para lidar com esses erros. A melhor resposta é informar aos chamadores upstream ou ao jogador que não é possível estabelecer uma conexão. Eles podem então iniciar a operação novamente mais tarde.