Publicar jugadores recientes del servidor

Anexa a las listas de jugadores recientes de un conjunto de usuarios o las actualiza (unidireccional). Se trata básicamente de una API por lotes de la API de cliente, para servidores. Esta API permite que un servidor de juego anexe a las listas de jugadores recientes de un conjunto de usuarios, y actualice las entradas de jugadores recientes existentes. La lista de jugadores recientes de cada usuario es unidireccional.

POST /titles/{titleId}/recentplayers/server

Parámetros de URI

Parámetro	En	Obligatorio	Tipo	Descripción
titleId	path	TRUE	integer	El titleId del juego para el que se envía la solicitud.

Encabezado de la solicitud

Nombre	Obligatorio	Tipo	Descripción
Authorization	TRUE	integer	El autor de la llamada debe proporcionar un XToken en el formato de autorización XBL 3.0. Por ejemplo, Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType debe establecerse en application/json

Cuerpo de la solicitud

Nombre	Obligatorio	Tipo	Descripción
recentPlayersByXuid	TRUE	ServerRecentPlayersByXuid[]	Matriz de objetos que representan un XUID y sus jugadores recientes. Debe haber al menos 1 entrada de XUID y como máximo 20.

Respuestas

Nombre	Tipo	Descripción
204 No Content		La solicitud de jugadores recientes se envió correctamente.
400 Bad Request	ErrorResponse	Se produjo un error al procesar la solicitud. Códigos de error posibles: “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
Otros códigos de estado	ThrottledEntity	Demasiadas solicitudes. Encabezados Retry-After: integer

EncounterType

El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada.

Nombre	Tipo	Descripción
Default	string
Opponent	string
Teammate	string

ErrorResponse

Nombre	Tipo	Descripción
debugMessage	string	Versión legible del mensaje de error que se puede usar para depurar.
errorCode	string	Enumeración de códigos de error.

Network

Nombre	Tipo	Descripción
XboxLive	string

ServerRecentPlayersByXuid

Nombre	Tipo	Descripción
recentPlayers	UnidirectionalRecentPlayer[]	La matriz de jugadores recientes de este usuario. Debe haber al menos 1 jugador reciente y como máximo 100.
xuid	string	El XUID del usuario (entero en base 10).

ServerRecentPlayersRequest

Nombre	Tipo	Descripción
recentPlayersByXuid	ServerRecentPlayersByXuid[]	Matriz de objetos que representan un XUID y sus jugadores recientes. Debe haber al menos 1 entrada de XUID y como máximo 20.

ThrottledEntity

Nombre	Tipo	Descripción
currentRequests	string	Número actual de solicitudes: simultaneidad o frecuencia.
debugMessage	string	Versión legible del mensaje de limitación que se puede usar para depurar.
limitType	string	El tipo de límite, es decir, simultaneidad o frecuencia.
maxRequests	string	Número máximo de solicitudes permitidas: simultaneidad o frecuencia.
periodInSeconds	string	El período en segundos que se aplica cuando se superan los límites de frecuencia o simultaneidad.
version	string	Versión actual del contrato de limitación.

UnidirectionalRecentPlayer

Nombre	Tipo	Descripción
encounterType	EncounterType	El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada.
id	string	El identificador (un XUID como entero en base 10) de otro usuario.
network	Network	La red en la que se encontró al otro usuario.
timestamp	string

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

POST /titles/{titleId}/recentplayers/server

Publicar jugadores recientes del servidor

Parámetros de URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Definiciones

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer

​Publicar jugadores recientes del servidor

​Parámetros de URI

​Encabezado de la solicitud

​Cuerpo de la solicitud

​Respuestas

​Definiciones

​EncounterType

​ErrorResponse

​Network

​ServerRecentPlayersByXuid

​ServerRecentPlayersRequest

​ThrottledEntity

​UnidirectionalRecentPlayer

Publicar jugadores recientes del servidor

Parámetros de URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Definiciones

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer