Pular para o conteúdo principal
Quando você encontra limitação no PlayFab, o PlayFab retorna um erro HTTP 429, sinalizando que uma chamada de API está sendo limitada. O cabeçalho e o corpo da resposta incluem informações importantes para entender o erro. Exemplo de cabeçalho:
Exemplo de corpo da resposta:
As propriedades “Retry-After e “retryAfterSeconds” indicam o tempo de espera em segundos antes de tentar outra solicitação para evitar a limitação. Se você usar o SDK do C/C++ multiplataforma mais recente, o SDK tentará lidar com a repetição em nome do chamador. Caso contrário, use as estratégias abaixo com os valores de repetição para desenvolver um tratamento personalizado.

Mitigar problemas de limitação

Se os erros de limitação persistirem, considere adotar as seguintes estratégias:
  1. Revisar a taxa de solicitações
    • Analise por que você está enviando um grande volume de solicitações.
    • Avalie formas de reduzir a taxa de solicitações para entidades específicas de jogador ou de título visadas pela API.
    • Para ver quais APIs e chamadores estão se aproximando de um limite ou atingindo-o, verifique o evento api_rate_limit_alert (versão prévia).
  2. Agrupar chamadas de API
    • Reduza a frequência agrupando as chamadas de API.
    • Exemplo: agrupe as atualizações de perfil a cada 10 segundos em vez de atualizar a cada segundo.

Principais conclusões

  • Os erros de limitação geram uma resposta HTTP 429 com detalhes sobre a natureza do erro.
  • Use as propriedades Retry-After e “retryAfterSeconds” para determinar o tempo de espera antes de fazer outra solicitação.
  • Avalie a necessidade de solicitações de alta frequência e otimize de acordo.
  • Implemente estratégias de agrupamento para aliviar os problemas de limitação e aumentar a eficiência geral do sistema.

Confira também

Última modificação em 19 de outubro de 2026