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

# Publier des joueurs récents (serveur)

> Publier des joueurs récents (serveur)

# Publier des joueurs récents (serveur)

Ajoute des entrées aux listes de joueurs récents d'un ensemble d'utilisateurs ou les met à jour (unidirectionnel). Il s'agit essentiellement d'une version par lots de l'API client, destinée aux serveurs.

Cette API permet à un serveur de jeu d'ajouter des entrées aux listes de joueurs récents d'un ensemble d'utilisateurs et de mettre à jour les entrées de joueurs récents existantes. La liste de joueurs récents de chaque utilisateur est unidirectionnelle.

```http theme={null}
POST /titles/{titleId}/recentplayers/server
```

<a id="uri-parameters" />

## Paramètres d'URI

| Paramètre | Emplacement | Obligatoire | Type | Description |
| - | - | - | - | - |
| titleId | path | TRUE | integer | titleId du jeu pour lequel la requête est envoyée. |

<a id="request-header" />

## En-tête de requête

| Nom | Obligatoire | Type | Description |
| - | - | - | - |
| Authorization | TRUE | integer | L'appelant doit fournir un XToken au format d'autorisation XBL 3.0. Par exemple, Authorization: XBL3.0 x=2553948354698;>jeton chiffré\<) |
| Content-Type | TRUE | string | ContentType doit être défini sur application/json |

<a id="request-body" />

## Corps de la requête

| Nom | Obligatoire | Type | Description |
| - | - | - | - |
| recentPlayersByXuid | TRUE | [ServerRecentPlayersByXuid](#serverrecentplayersbyxuid)\[] | Tableau d'objets représentant un XUID et ses joueurs récents. Il doit y avoir au moins 1 et au plus 20 entrées XUID. |

<a id="responses" />

## Réponses

| Nom | Type | Description |
| - | - | - |
| 204 No Content | | La requête de joueurs récents a été envoyée avec succès. |
| 400 Bad Request | [ErrorResponse](#errorresponse) | Une erreur s'est produite lors du traitement de la requête. Codes d'erreur possibles : "RequestValidationError: La validation de la requête a échoué.", " AuthorizationError: L'appelant n'est pas autorisé à accéder à la ressource." |
| Autres codes d'état | [ThrottledEntity](#throttledentity) | Trop de requêtes. En-têtes Retry-After: integer |

<a id="definitions" />

## Définitions

* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [ServerRecentPlayersByXuid](#serverrecentplayersbyxuid)
* [ServerRecentPlayersRequest](#serverrecentplayersrequest)
* [ThrottledEntity](#throttledentity)
* [UnidirectionalRecentPlayer](#unidirectionalrecentplayer)

<a id="encountertype" />

### EncounterType

Type de rencontre de joueurs récents. Ce champ est facultatif et sa valeur par défaut est Default. Default n'a pas de signification prescrite : il revient à l'appelant d'interpréter cette valeur de manière appropriée.

| Nom | Type | Description |
| - | - | - |
| Default | string | |
| Opponent | string | |
| Teammate | string | |

<a id="errorresponse" />

### ErrorResponse

| Nom | Type | Description |
| - | - | - |
| debugMessage | string | Version lisible du message d'erreur, utilisable pour le débogage. |
| errorCode | string | Énumération du code d'erreur. |

<a id="network" />

### Network

| Nom | Type | Description |
| - | - | - |
| XboxLive | string | |

<a id="serverrecentplayersbyxuid" />

### ServerRecentPlayersByXuid

| Nom | Type | Description |
| - | - | - |
| recentPlayers | [UnidirectionalRecentPlayer](#unidirectionalrecentplayer)\[] | Tableau des joueurs récents de cet utilisateur. Il doit y avoir au moins 1 joueur récent et au plus 100 joueurs récents. |
| xuid | string | XUID de l'utilisateur (entier en base 10). |

<a id="serverrecentplayersrequest" />

### ServerRecentPlayersRequest

| Nom | Type | Description |
| - | - | - |
| recentPlayersByXuid | [ServerRecentPlayersByXuid](#serverrecentplayersbyxuid)\[] | Tableau d'objets représentant un XUID et ses joueurs récents. Il doit y avoir au moins 1 et au plus 20 entrées XUID. |

<a id="throttleentity" />

### ThrottledEntity

| Nom | Type | Description |
| - | - | - |
| currentRequests | string | Nombre actuel de requêtes (simultanéité ou débit). |
| debugMessage | string | Version lisible du message de limitation, utilisable pour le débogage. |
| limitType | string | Type de limite, c'est-à-dire simultanéité ou débit. |
| maxRequests | string | Nombre maximal de requêtes autorisées (simultanéité ou débit). |
| periodInSeconds | string | Période en secondes qui s'applique en cas de dépassement des limites de débit ou de simultanéité. |
| version | string | Version actuelle du contrat de limitation. |

<a id="unidirectionalrecentplayer" />

## UnidirectionalRecentPlayer

| Nom | Type | Description |
| - | - | - |
| encounterType | [EncounterType](#encountertype) | Type de rencontre de joueurs récents. Ce champ est facultatif et sa valeur par défaut est Default. Default n'a pas de signification prescrite : il revient à l'appelant d'interpréter cette valeur de manière appropriée. |
| id | string | ID (XUID sous forme d'entier en base 10) d'un autre utilisateur. |
| network | [Network](#network) | Réseau sur lequel l'autre utilisateur a été rencontré. |
| timestamp | string | |


## Related topics

- [XR-067 Maintien des interactions Joueurs récents](/fr-CA/publishing/certification/xr/xr-067.md)
- [Joueurs récents](/fr/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players.md)
- [Publier des dispositions tactiles](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-publishing-layouts.md)
- [Vue d'ensemble de la fonctionnalité Multiplayer Activity (MPA)](/fr/services/xbox-services/multiplayer/mpa/live-mpa-overview.md)
- [Multiplayer Activity (MPA)](/fr/services/xbox-services/multiplayer/mpa/live-mpa-nav.md)