Postar grupo de jogadores recentes do servidor

Acrescenta ou atualiza os jogadores recentes de todos os usuários de um grupo (bidirecional). 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. Todos os usuários de um grupo são adicionados às listas de jogadores recentes uns dos outros (bidirecional). Exemplo de grupos de jogadores recentes: [ [A,B,C], [A,D], [E,F] ]. A encontrou B, C e D. B encontrou A e C. D encontrou apenas A, e assim por diante.

POST /titles/{titleId}/recentplayergroups/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
recentPlayerGroups	TRUE	RecentPlayerGroup[]	A matriz de grupos bidirecionais de jogadores recentes. Deve haver no mínimo 1 grupo e no máximo 20 grupos. Em cada grupo, deve haver no mínimo 2 jogadores e no máximo 100.

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

BidirectionalRecentPlayer

Nome	Tipo	Descrição
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.

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

RecentPlayerGroup

Todos os usuários de um grupo se encontraram no horário especificado. Cada grupo deve conter no mínimo 2 e no máximo 100 usuários.

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

ServerRecentPlayerGroupsRequest

Todos os usuários de um grupo se encontraram no horário especificado. Cada grupo deve conter no mínimo 2 e no máximo 100 usuários.

Nome	Tipo	Descrição
recentPlayerGroups	RecentPlayerGroup	A matriz de grupos bidirecionais de jogadores recentes. Deve haver no mínimo 1 grupo e no máximo 20 grupos. Em cada grupo, deve haver no mínimo 2 jogadores e no máximo 100.

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.

Porting

Build Paths

Postar grupo de jogadores recentes do servidor

Postar grupo de jogadores recentes do servidor

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Definições

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity

​Postar grupo de jogadores recentes do servidor

​Parâmetros de URI

​Cabeçalho da solicitação

​Corpo da solicitação

​Respostas

​Definições

​BidirectionalRecentPlayer

​EncounterType

​ErrorResponse

​Network

​RecentPlayerGroup

​ServerRecentPlayerGroupsRequest

​ThrottledEntity

Postar grupo de jogadores recentes do servidor

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Definições

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity