> ## 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.

# api_rate_limit_alert

> Evento do PlayFab em versão prévia gerado quando um chamador de API se aproxima ou atinge um limite de taxa, com propriedades para a API, a entidade chamadora e os limites ultrapassados.

> \[!NOTE]
> Este evento está em versão prévia. Sua carga, comportamento e disponibilidade podem mudar.

Este evento pode ser disparado quando um chamador de API se aproxima ou atinge um limite de taxa. Atualmente, um aviso é gerado em 80% do limite, mas esse limiar, assim como outros detalhes do evento, pode mudar. Um alerta é gerado na primeira vez que o uso ultrapassa o limiar de aviso (`Warning`) ou o próprio limite (`HardLimit`) dentro de um período de rastreamento, e não em todas as chamadas posteriores. Para saber se as chamadas estão sendo limitadas, use as respostas HTTP 429. Você pode consultá-lo no **Data Explorer** do Game Manager. Para obter mais informações sobre limites de taxa, consulte [Limitação no PlayFab](/pt-BR/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling).

## Propriedades

| Nome | Tipo | Descrição |
| :- | :- | :- |
| API | String | A API do PlayFab que foi chamada. Por exemplo, `client/gettime`. |
| CallerEntityType | String | O tipo de entidade que fez a chamada. Por exemplo, `title_player_account` ou `title`. |
| CallerEntityId | String | A ID da entidade que fez a chamada. Pode ser omitida ou mascarada. |
| Crossings | object\[] | Os limites de taxa dos quais a chamada se aproximou ou que atingiu. Em cada entrada, `CrossingType` é `Warning` quando um limite está sendo aproximado ou `HardLimit` quando ele é atingido, e `LimitKind`, `TrackingPeriod` e `Limit` descrevem o limite. As entradas de limites em uma entidade de destino também incluem `TargetEntityType` e `TargetEntityId`, e essa ID pode ser omitida ou mascarada. |

## Propriedades comuns

Todos os eventos V2 do PlayStream são formatados como objetos JSON e a maioria compartilha as seguintes propriedades comuns:

| Nome | Tipo | Descrição |
| :- | :- | :- |
| SchemaVersion | String | Versão do formato de evento do PlayStream, seguindo um esquema de controle de versão semântico. |
| FullName | [Object](/pt-BR/services/playfab/api-references/events/data-types/fullnameobject) | Combinação do nome e do namespace do evento para especificar totalmente o tipo de evento. |
| Id | String | Identificador exclusivo atribuído pelo PlayFab para este evento. |
| Timestamp | DateTime | A hora (em UTC) associada a este evento. |
| Entity | [Object](/pt-BR/services/playfab/api-references/events/data-types/entityobject) | Detalhes sobre a entidade à qual este evento se aplica, incluindo a ID e o tipo da entidade. |
| Originator | [Object](/pt-BR/services/playfab/api-references/events/data-types/originatorobject) | Objeto que descreve a origem e o tipo de origem que iniciou este evento. |
| PayloadContentType | String | Especifica o conteúdo da carga do evento. O padrão é "JSON". |
| Origin Info | Object | Campo opcional que contém informações sobre eventos originados fora do PlayFab. |


## Related topics

- [Referência do modelo de eventos do PlayStream para o PlayFab](/pt-BR/services/playfab/api-references/events/index.md)
- [Eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [Práticas recomendadas de limitação](/pt-BR/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [title_client_rate_limited_alert](/pt-BR/services/playfab/api-references/events/Title/title-client-rate-limited-alert.md)
- [title_high_error_rate_alert](/pt-BR/services/playfab/api-references/events/Title/title-high-error-rate-alert.md)