Publier des joueurs récents (serveur)

Ajoute des éléments 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 cliente, pour les serveurs. 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. La liste de joueurs récents de chaque utilisateur est unidirectionnelle.

POST /titles/{titleId}/recentplayers/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
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: 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

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

ServerRecentPlayersByXuid

Nom	Type	Description
recentPlayers	UnidirectionalRecentPlayer[]	Le 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	chaîne	Le 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	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.

UnidirectionalRecentPlayer

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.
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é.
timestamp	chaîne

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

Corps de la requête

Réponses

Définitions

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer