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

# GET (/handles/{handleId}/session)

> GET (/handles/{handleId}/session)

# GET (/handles/{handleId}/session)

Obtém um objeto de sessão para o identificador especificado.

> **Importante:**\
> Este método é usado pelo Multiplayer 2015 e se aplica somente a essa versão multijogador e posteriores. Ele se destina ao uso com o contrato de modelo 104/105 ou posterior e requer um elemento de cabeçalho X-Xbl-Contract-Version: 104/105 ou posterior em todas as solicitações.

* [Comentários](#ID4ET)
* [Parâmetros de URI](#ID4EDB)
* [Códigos de status HTTP](#ID4EOB)
* [Corpo da solicitação](#ID4EVB)
* [Corpo da resposta](#ID4E6B)

<a id="ID4ET" />

## Comentários

Este método HTTP/REST recupera um objeto de sessão do servidor, usando o ponteiro do lado do serviço fornecido para a sessão (identificador). O retorno é o objeto de sessão, com todos os seus atributos. Este método pode ser encapsulado por **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync**.

O chamador deste método obtém a ID do identificador a partir do objeto **MultiplayerActivityDetails** de um jogador. Como alternativa, o chamador obtém a ID de uma ativação de protocolo depois que um usuário aceita um convite de jogo.

<a id="ID4EDB" />

## Parâmetros de URI

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- |
\| handleId| GUID| A ID exclusiva do identificador da sessão.|

<a id="ID4EOB" />

## Códigos de status HTTP

O serviço retorna um código de status HTTP conforme aplicável ao MPSD.

<a id="ID4EVB" />

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

<a id="ID4E6B" />

## Corpo da resposta

Veja a estrutura da resposta em [MultiplayerSession (JSON)](/pt-BR/reference/live/rest/json/json-multiplayersession).

<a id="ID4EIC" />

## Confira também

<a id="ID4EKC" />

##### Pai

[/handles/{handleId}/session](/pt-BR/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)


## Related topics

- [XblMultiplayerGetSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)