> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postar jogadores recentes do servidor

> Postar jogadores recentes do servidor

# 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.

```http theme={null}
POST /titles/{titleId}/recentplayers/server
```

<a id="uri-parameters" />

## 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. |

<a id="request-header" />

## 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 |

<a id="request-body" />

## Corpo da solicitação

| Nome | Obrigatório | Tipo | Descrição |
| - | - | - | - |
| recentPlayersByXuid | TRUE | [ServerRecentPlayersByXuid](#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. |

<a id="responses" />

## Respostas

| Nome | Tipo | Descrição |
| - | - | - |
| 204 No Content | | A solicitação de jogadores recentes foi enviada com êxito. |
| 400 Bad Request | [ErrorResponse](#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](#throttledentity) | Excesso de solicitações. Cabeçalhos Retry-After: integer |

<a id="definitions" />

## Definições

* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [ServerRecentPlayersByXuid](#serverrecentplayersbyxuid)
* [ServerRecentPlayersRequest](#serverrecentplayersrequest)
* [ThrottledEntity](#throttledentity)
* [UnidirectionalRecentPlayer](#unidirectionalrecentplayer)

<a id="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.

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

<a id="errorresponse" />

### 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. |

<a id="network" />

### Network

| Nome | Tipo | Descrição |
| - | - | - |
| XboxLive | string | |

<a id="serverrecentplayersbyxuid" />

### ServerRecentPlayersByXuid

| Nome | Tipo | Descrição |
| - | - | - |
| recentPlayers | [UnidirectionalRecentPlayer](#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). |

<a id="serverrecentplayersrequest" />

### ServerRecentPlayersRequest

| Nome | Tipo | Descrição |
| - | - | - |
| recentPlayersByXuid | [ServerRecentPlayersByXuid](#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. |

<a id="throttleentity" />

### 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. |

<a id="unidirectionalrecentplayer" />

## UnidirectionalRecentPlayer

| Nome | Tipo | Descrição |
| - | - | - |
| encounterType | [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](#network) | A rede na qual o outro usuário foi encontrado. |
| timestamp | string | |


## Related topics

- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [XR-067 Manutenção das interações de Jogou recentemente com](/pt-BR/publishing/certification/xr/xr-067.md)
- [Casos de teste com mais falhas](/pt-BR/publishing/certification/xr-top-failing.md)
- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [XR-014 Dados do jogador e informações pessoais](/pt-BR/publishing/certification/xr/xr-014.md)