Pular para o conteúdo principal
Os recursos de API no PlayFab Game Manager são algumas opções para gerenciar o comportamento das APIs do PlayFab no seu título. Essas opções fornecem as ferramentas para gerenciar acesso, privacidade e outros recursos. Para localizar a tela de configuração dessas opções:
  • Acesse o Game Manager.
  • Selecione Settings no menu à esquerda.
  • Selecione a guia API Features.
Game Manager: Settings: API Features Algumas dessas caixas de seleção são óbvias, enquanto outras não. Neste tutorial, entraremos em detalhes sobre várias delas.
Várias capturas de tela e demonstrações deste tutorial usam o Postman.

​
Exigir JSON válido para valores de dados personalizados

Clientes hackeados podem causar problemas sérios para os jogos. Chamadores de API mal-intencionados que publicam dados mal formatados podem gerar ruído, bugs e problemas para os desenvolvedores. Jogadores com dados mal formatados geralmente exigem intervenção manual para limpeza. Exigir JSON válido para valores de dados personalizados executará uma validação básica do tipo de conteúdo antes que os dados sejam salvos no banco de dados. Detectar esses problemas cedo evita que eles persistam e impede que hackers interfiram no desenvolvimento normal. Quando esse sinalizador está definido, ele força os clientes a passar JSON válido para cada chave dos dados personalizados. A validação simples de JSON por si só não evitará todos os problemas, mas pode ajudar a eliminar alguns comportamentos indesejados. Marcar essa opção exigirá que cada chave salva em todos os dados personalizados, incluindo dados de jogador, publicador, personagem, título e item, seja um JSON válido.
Esse sinalizador pode ser ativado ou desativado a qualquer momento. Mas ele não é retroativo. Portanto, os valores existentes não serão afetados. Somente os valores gravados recentemente serão validados.
Se você tentar passar um JSON inválido como valor, a solicitação será rejeitada com HTTP Status Code 400 "Bad Request". Postman: enviar JSON inválido

​
Desabilitar todo o acesso a solicitações de API

Surpreendentemente, pode ser útil desabilitar todo o acesso à API dos seus títulos. Se, por exemplo, você estiver realizando uma migração delicada com tempo de inatividade, solicitações de API perdidas podem causar interrupções graves. Se você estiver desativando seu jogo, isso garantirá que ele esteja realmente desligado.
Lembre-se de que marcar essa caixa de seleção literalmente quebrará seu jogo, portanto use-a com cautela!
Depois de decidir que precisa desativar o acesso à API e marcar a caixa, todas as solicitações de API começarão a falhar em alguns minutos. O PlayFab retornará HTTP Status Code 400 "Bad Request", indicando que o título desabilitou esse uso. Postman: acessar uma API desabilitada Essas respostas HTTP Status Code 400 persistirão até que você desmarque a caixa. Novamente, desmarcar pode levar alguns minutos para entrar em vigor.

​
Habilitar o ofuscamento do endereço IP do jogador

Para muitos estúdios, possuir informações de identificação pessoal (PII) é uma responsabilidade que é melhor evitar. Uma forma comum (e útil) de PII é o endereço IP. O endereço IP é útil por vários motivos, incluindo a geolocalização. No entanto, a precisão completa do IP costuma ser considerada PII. O PlayFab pode ajudar a limitar isso ofuscando partes dos endereços IP. Agora, ao marcar uma caixa, você pode parar de coletar esses dados confidenciais. Depois que você marcar essa caixa, o PlayFab sempre registrará 0 no último octeto do IP de um jogador. Você pode verificar se isso está funcionando consultando o histórico de login dos jogadores na guia Players. Você deverá ver que todos os IPs terminam em .0. Os IPs registrados antes da habilitação do ofuscamento do endereço IP manterão todos os detalhes. Portanto, se o seu jogo for sensível a PII, marque essa caixa de seleção antes do lançamento.
Habilitar o ofuscamento afeta outros recursos que usam endereços IP. Os três mais diretamente afetados são a geolocalização baseada em IP, os banimentos de IP e os banimentos de jogadores que especificam um endereço IP.
O PlayFab executa automaticamente a geolocalização baseada em IP nos logins. Isso ajuda a determinar automaticamente de onde no mundo seus jogadores vêm. No entanto, você poderá ter uma precisão reduzida, especialmente no nível de cidade, ao usar IPs ofuscados. Isso é intencional, pois o objetivo de ofuscar os IPs é evitar o registro de PII, incluindo localizações exatas. Além disso, ofuscar IPs pode afetar os banimentos de IP. Muitas vezes, emitir um banimento de IP é mais prático do que banir uma conta por vez, pois o mal-intencionado pode simplesmente criar novas contas. Banir um IP impede que o mal-intencionado crie novas contas a partir da mesma conexão de Internet. Em muitos casos, essa é uma ferramenta eficaz. No entanto, com IPs ofuscados, banir um IP exato não funciona. Em vez disso, você precisa usar um banimento em um IP com .0 como octeto final. Lembre-se de que isso efetivamente banirá um intervalo inteiro de IPs. Game Manager: IP Bans: adicionar banimento Para explicitar o escopo, insira o intervalo CIDR equivalente em vez de depender de um endereço ofuscado terminado em .0, conforme mostrado abaixo. Os dois banimentos são funcionalmente equivalentes. Game Manager: IP Bans: banimento por intervalo Isso ainda banirá o mal-intencionado, mas outros jogadores inocentes com endereços IP semelhantes poderão ser afetados. Além disso, os banimentos existentes para endereços IP específicos e não ofuscados deixarão de ser eficazes.
Última modificação em 8 de outubro de 2026