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

> Événement PlayFab en préversion déclenché lorsqu'un appelant d'API approche ou atteint une limite de débit, avec des propriétés pour l'API, l'entité appelante et les franchissements de limite.

> \[!NOTE]
> Cet événement est en préversion. Sa charge utile, son comportement et sa disponibilité peuvent changer.

Cet événement peut être déclenché lorsqu'un appelant d'API approche ou atteint une limite de débit. Un avertissement est actuellement émis à 80 % de la limite, mais ce seuil, comme d'autres détails de l'événement, peut changer. Une alerte est émise la première fois que l'utilisation franchit le seuil d'avertissement (`Warning`) ou la limite elle-même (`HardLimit`) au cours d'une période de suivi, et non à chaque appel par la suite. Pour savoir si les appels sont limités, utilisez les réponses HTTP 429. Vous pouvez l'interroger dans l'**Explorateur de données** (Data Explorer) de Game Manager. Pour plus de renseignements sur les limites de débit, consultez [Limitation dans PlayFab](/fr-CA/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling).

## Propriétés

| Nom | Type | Description |
| :- | :- | :- |
| API | String | API PlayFab qui a été appelée. Par exemple, `client/gettime`. |
| CallerEntityType | String | Type d'entité qui a effectué l'appel. Par exemple, `title_player_account` ou `title`. |
| CallerEntityId | String | ID de l'entité qui a effectué l'appel. Peut être omis ou masqué. |
| Crossings | object\[] | Limites de débit que l'appel a approchées ou atteintes. Dans chaque entrée, `CrossingType` vaut `Warning` lorsqu'une limite est approchée ou `HardLimit` lorsqu'elle est atteinte, et `LimitKind`, `TrackingPeriod` et `Limit` décrivent la limite. Les entrées relatives aux limites sur une entité cible incluent également `TargetEntityType` et `TargetEntityId`, et cet ID peut être omis ou masqué. |

## Propriétés communes

Tous les événements PlayStream V2 sont mis en forme sous forme d'objets JSON et la plupart partagent les propriétés communes suivantes :

| Nom | Type | Description |
| :- | :- | :- |
| SchemaVersion | String | Version du format d'événement PlayStream, selon un schéma de gestion sémantique des versions. |
| FullName | [Object](/fr-CA/services/playfab/api-references/events/data-types/fullnameobject) | Combinaison du nom et de l'espace de noms de l'événement permettant de spécifier entièrement le type d'événement. |
| Id | String | Identificateur unique attribué par PlayFab à cet événement. |
| Timestamp | DateTime | Heure (en UTC) associée à cet événement. |
| Entity | [Object](/fr-CA/services/playfab/api-references/events/data-types/entityobject) | Détails sur l'entité à laquelle cet événement s'applique, y compris l'Entity Id et l'Entity type. |
| Originator | [Object](/fr-CA/services/playfab/api-references/events/data-types/originatorobject) | Objet décrivant la source et le type de source à l'origine de cet événement. |
| PayloadContentType | String | Spécifie le contenu de la charge utile de l'événement. La valeur par défaut est "JSON". |
| Origin Info | Object | Champ facultatif contenant des renseignements sur les événements provenant de l'extérieur de PlayFab. |


## Related topics

- [Référence du modèle d'événements PlayStream pour PlayFab](/fr-CA/services/playfab/api-references/events/index.md)
- [Événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [Pratiques exemplaires en matière de limitation](/fr-CA/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [title_client_rate_limited_alert](/fr-CA/services/playfab/api-references/events/Title/title-client-rate-limited-alert.md)
- [title_high_error_rate_alert](/fr-CA/services/playfab/api-references/events/Title/title-high-error-rate-alert.md)