> ## 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 grupo de jogadores recentes do servidor

> Postar grupo de jogadores recentes do servidor

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

```http theme={null}
POST /titles/{titleId}/recentplayergroups/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 |
| - | - | - | - |
| recentPlayerGroups | TRUE | [RecentPlayerGroup](#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. |

<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

* [BidirectionalRecentPlayer](#bidirectionalrecentplayer)
* [EncounterType](#encountertype)
* [ErrorResponse](#errorresponse)
* [Network](#network)
* [RecentPlayerGroup](#recentplayergroup)
* [ServerRecentPlayerGroupsRequest](#serverrecentplayergroupsrequest)
* [ThrottledEntity](#throttledentity)

<a id="bidirectionalrecentplayer" />

### BidirectionalRecentPlayer

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

<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="recentplayergroup" />

### 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](#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](#bidirectionalrecentplayer)\[] | |
| timestamp | string | |

<a id="serverrecentplayergroupsrequest" />

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

<a id="throttledentity" />

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


## 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)
- [XR067 Manutenção das interações de Jogou recentemente com](/pt-BR/publishing/certification/fma/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)