> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Práticas recomendadas de limitação

> Trate as respostas de limitação HTTP 429 do PlayFab com cabeçalhos Retry-After, agrupamento de solicitações e estratégias de mitigação de taxa para manter o tráfego da API dentro dos limites.

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:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 8
```

Exemplo de corpo da resposta:

```json theme={null}
{ 
  "code": 429, 
  "status": "TooManyRequests", 
  "retryAfterSeconds": 8, 
  "error": "APIClientRequestRateLimitExceeded", 
  "errorCode": 1199, 
  "errorMessage": "The client has exceeded the maximum API request rate and is being throttled" 
} 
```

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](/pt-BR/services/playfab/sdks/c/index) 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](https://learn.microsoft.com/gaming/playfab/api-references/events/Title/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

* [Limites do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [Práticas recomendadas para chamar os serviços do XBOX](/pt-BR/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)
- [Práticas recomendadas e recomendações de experimentos](/pt-BR/services/playfab/live-service-management/game-configuration/experiments/experimentation-keys.md)
- [Práticas recomendadas de atualização de conteúdo](/pt-BR/build/core-features/common/packaging/packaging-updates.md)
- [Noções básicas e práticas recomendadas de login](/pt-BR/services/playfab/identity/player-identity/login/login-basics-best-practices.md)
- [Práticas recomendadas e lista de verificação de lançamento](/pt-BR/services/playfab/multiplayer/servers/best-practices.md)