Postar jogadores recentes do servidor

Acrescenta ou atualiza as listas de jogadores recentes de um conjunto de usuários (unidirecional). Essencialmente, é uma versão em lote da API do cliente, para servidores. Essa API permite que um servidor de jogo acrescente às listas de jogadores recentes de um conjunto de usuários e atualize as entradas de jogadores recentes existentes. A lista de jogadores recentes de cada usuário é unidirecional.

POST /titles/{titleId}/recentplayers/server

Parâmetros de URI

Parâmetro	Em	Obrigatório	Tipo	Descrição
titleId	path	TRUE	integer	O titleId do jogo para o qual a solicitação está sendo enviada.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Descrição
Authorization	TRUE	integer	O chamador deve fornecer um XToken no formato de autorização XBL 3.0. Por exemplo, Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType deve ser definido como application/json

Corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
recentPlayersByXuid	TRUE	ServerRecentPlayersByXuid[]	Matriz de objetos que representam um XUID e seus jogadores recentes. Deve haver no mínimo 1 e no máximo 20 entradas de XUID.

Respostas

Nome	Tipo	Descrição
204 No Content		A solicitação de jogadores recentes foi enviada com êxito.
400 Bad Request	ErrorResponse	Ocorreu um erro ao processar a solicitação. Códigos de erro possíveis: “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
Outros códigos de status	ThrottledEntity	Excesso de solicitações. Cabeçalhos Retry-After: integer

EncounterType

O tipo de encontro de jogadores recentes. Este campo é opcional e assume Default como padrão. Default não tem um significado prescrito; cabe ao chamador interpretar esse valor adequadamente.

Nome	Tipo	Descrição
Default	string
Opponent	string
Teammate	string

ErrorResponse

Nome	Tipo	Descrição
debugMessage	string	Versão legível da mensagem de erro que pode ser usada para depuração.
errorCode	string	Enumeração do código de erro.

Network

Nome	Tipo	Descrição
XboxLive	string

ServerRecentPlayersByXuid

Nome	Tipo	Descrição
recentPlayers	UnidirectionalRecentPlayer[]	A matriz de jogadores recentes deste usuário. Deve haver no mínimo 1 e no máximo 100 jogadores recentes.
xuid	string	O XUID do usuário (inteiro de base 10).

ServerRecentPlayersRequest

Nome	Tipo	Descrição
recentPlayersByXuid	ServerRecentPlayersByXuid[]	Matriz de objetos que representam um XUID e seus jogadores recentes. Deve haver no mínimo 1 e no máximo 20 entradas de XUID.

ThrottledEntity

Nome	Tipo	Descrição
currentRequests	string	Número atual de solicitações: simultaneidade ou taxa.
debugMessage	string	Versão legível da mensagem de limitação que pode ser usada para depuração.
limitType	string	O tipo de limite, ou seja, simultaneidade ou taxa.
maxRequests	string	Máximo de solicitações permitidas: simultaneidade ou taxa.
periodInSeconds	string	O período, em segundos, que se aplica quando os limites de taxa ou simultaneidade são excedidos.
version	string	Versão atual do contrato de limitação.

UnidirectionalRecentPlayer

Nome	Tipo	Descrição
encounterType	EncounterType	O tipo de encontro de jogadores recentes. Este campo é opcional e assume Default como padrão. Default não tem um significado prescrito; cabe ao chamador interpretar esse valor adequadamente.
id	string	A ID (um inteiro XUID de base 10) de outro usuário.
network	Network	A rede na qual o outro usuário foi encontrado.
timestamp	string

Porting

Build Paths

Postar jogadores recentes do servidor

Postar jogadores recentes do servidor

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Definições

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer

​Postar jogadores recentes do servidor

​Parâmetros de URI

​Cabeçalho da solicitação

​Corpo da solicitação

​Respostas

​Definições

​EncounterType

​ErrorResponse

​Network

​ServerRecentPlayersByXuid

​ServerRecentPlayersRequest

​ThrottledEntity

​UnidirectionalRecentPlayer

Postar jogadores recentes do servidor

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Definições

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer