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.

POST /titles/{titleId}/recentplayers/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
recentPlayersByXuid	TRUE	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.

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

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

ServerRecentPlayersByXuid

Nom	Type	Description
recentPlayers	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).

ServerRecentPlayersRequest

Nom	Type	Description
recentPlayersByXuid	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.

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.

UnidirectionalRecentPlayer

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.
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é.
timestamp	string

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Publier des joueurs récents (serveur)

Publier des joueurs récents (serveur)

Paramètres d’URI

En-tête de requête

Corps de la requête

Réponses

Définitions

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer

​Publier des joueurs récents (serveur)

​Paramètres d’URI

​En-tête de requête

​Corps de la requête

​Réponses

​Définitions

​EncounterType

​ErrorResponse

​Network

​ServerRecentPlayersByXuid

​ServerRecentPlayersRequest

​ThrottledEntity

​UnidirectionalRecentPlayer

Publier des joueurs récents (serveur)

Paramètres d’URI

En-tête de requête

Corps de la requête

Réponses

Définitions

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer