> ## 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 ultérieur. Pour savoir si les appels sont limités, utilisez les réponses HTTP 429. Vous pouvez l'interroger dans l'**Explorateur de données** de Game Manager. Pour plus d'informations sur les limites de débit, consultez [Limitation dans PlayFab](/fr/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling).

## Propriétés

| Nom | Type | Description |
| :- | :- | :- |
| API | String | API PlayFab appelée. Par exemple, `client/gettime`. |
| CallerEntityType | String | Type de l'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 en tant qu'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 de version. |
| FullName | [Object](/fr/services/playfab/api-references/events/data-types/fullnameobject) | Combinaison du nom et de l'espace de noms de l'événement pour 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/services/playfab/api-references/events/data-types/entityobject) | Détails sur l'entité à laquelle s'applique cet événement, y compris l'ID et le type d'entité. |
| Originator | [Object](/fr/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 informations 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/services/playfab/api-references/events/index.md)
- [Événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [Bonnes pratiques en matière de limitation](/fr/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [title_client_rate_limited_alert](/fr/services/playfab/api-references/events/Title/title-client-rate-limited-alert.md)
- [title_high_error_rate_alert](/fr/services/playfab/api-references/events/Title/title-high-error-rate-alert.md)