Publier un groupe de joueurs récents (serveur)

Ajoute des entrées aux joueurs récents de tous les utilisateurs d’un groupe ou les met à jour (bidirectionnel). 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. 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	Emplacement	Obligatoire	Type	Description
titleId	path	TRUE	integer	titleId du jeu pour lequel la requête est envoyée.

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

Corps de la requête

Nom	Obligatoire	Type	Description
recentPlayerGroups	TRUE	RecentPlayerGroup[]	Tableau de 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: La validation de la requête a échoué.”, ” AuthorizationError: L’appelant n’est pas autorisé à accéder à la ressource.”
Autres codes d’état	ThrottledEntity	Trop de requêtes. En-têtes Retry-After: integer

BidirectionalRecentPlayer

Nom	Type	Description
id	string	ID (XUID sous forme d’entier en base 10) d’un autre utilisateur.
network	Network	Réseau sur lequel l’autre utilisateur a été rencontré.

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

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.

Network

Nom	Type	Description
XboxLive	string

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	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.
recentPlayers	BidirectionalRecentPlayer[]
timestamp	string

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	Tableau de 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	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.

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 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 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 requête

Corps de la requête

Réponses

Définitions

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity