Publier un groupe de joueurs récents (serveur)

Ajoute ou met à jour les joueurs récents de tous les utilisateurs d’un groupe (bidirectionnel). Cette API permet à un serveur de jeu d’ajouter des éléments aux listes de joueurs récents d’un ensemble d’utilisateurs et de mettre à jour les entrées de joueurs récents existantes. Tous les utilisateurs d’un groupe sont ajoutés aux listes de joueurs récents les uns des autres (bidirectionnel). Exemple de groupes de joueurs récents : [ [A,B,C], [A,D], [E,F] ]. A a rencontré B, C et D. B a rencontré A et C. D n’a rencontré que A, et ainsi de suite.

POST /titles/{titleId}/recentplayergroups/server

Paramètres d’URI

Paramètre	Dans	Obligatoire	Type	Description
titleId	chemin	TRUE	entier	Le titleId du jeu pour lequel la requête est envoyée.

En-tête de la requête

Nom	Obligatoire	Type	Description
Authorization	TRUE	entier	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	chaîne	ContentType doit être défini sur application/json

Corps de la requête

Nom	Obligatoire	Type	Description
recentPlayerGroups	TRUE	RecentPlayerGroup[]	Le tableau des groupes de joueurs récents bidirectionnels. Il doit y avoir au moins 1 groupe et au plus 20 groupes. Chaque groupe doit compter au moins 2 joueurs et au plus 100.

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	Une erreur s’est produite lors du traitement de la requête. Codes d’erreur possibles : “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
Autres codes d’état	ThrottledEntity	Trop de requêtes. En-têtes Retry-After: integer

BidirectionalRecentPlayer

Nom	Type	Description
id	chaîne	L’ID (un XUID sous forme d’entier en base 10) d’un autre utilisateur.
network	Network	Le réseau sur lequel l’autre utilisateur a été rencontré.

EncounterType

Le 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 façon appropriée.

Nom	Type	Description
Default	chaîne
Opponent	chaîne
Teammate	chaîne

ErrorResponse

Nom	Type	Description
debugMessage	chaîne	Version lisible du message d’erreur pouvant être utilisée pour le débogage.
errorCode	chaîne	Énumération du code d’erreur.

Network

Nom	Type	Description
XboxLive	chaîne

RecentPlayerGroup

Tous les utilisateurs d’un groupe se sont rencontrés à l’heure spécifiée. Chaque groupe doit contenir au moins 2 et jusqu’à 100 utilisateurs.

Nom	Type	Description
encounterType	EncounterType	Le 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 façon appropriée.
recentPlayers	BidirectionalRecentPlayer[]
timestamp	chaîne

ServerRecentPlayerGroupsRequest

Tous les utilisateurs d’un groupe se sont rencontrés à l’heure spécifiée. Chaque groupe doit contenir au moins 2 et jusqu’à 100 utilisateurs.

Nom	Type	Description
recentPlayerGroups	RecentPlayerGroup	Le tableau des groupes de joueurs récents bidirectionnels. Il doit y avoir au moins 1 groupe et au plus 20 groupes. Chaque groupe doit compter au moins 2 joueurs et au plus 100.

ThrottledEntity

Nom	Type	Description
currentRequests	chaîne	Nombre actuel de requêtes - simultanéité ou débit.
debugMessage	chaîne	Version lisible du message de limitation pouvant être utilisée pour le débogage.
limitType	chaîne	Le type de limite, c’est-à-dire simultanéité ou débit.
maxRequests	chaîne	Nombre maximal de requêtes autorisées - simultanéité ou débit.
periodInSeconds	chaîne	La période en secondes qui s’applique lorsque les limites de débit ou de simultanéité sont dépassées.
version	chaîne	Version actuelle du contrat de limitation.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Publier un groupe de joueurs récents (serveur)

Publier un groupe de joueurs récents (serveur)

Paramètres d’URI

En-tête de la requête

Corps de la requête

Réponses

Définitions

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity

​Publier un groupe de joueurs récents (serveur)

​Paramètres d’URI

​En-tête de la requête

​Corps de la requête

​Réponses

​Définitions

​BidirectionalRecentPlayer

​EncounterType

​ErrorResponse

​Network

​RecentPlayerGroup

​ServerRecentPlayerGroupsRequest

​ThrottledEntity

Publier un groupe de joueurs récents (serveur)

Paramètres d’URI

En-tête de la requête

Corps de la requête

Réponses

Définitions

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity