> ## 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/{handle-id})

> GET (/handles/{handle-id})

# GET (/handles/{handle-id})

Recupera os identificadores especificados pela ID do identificador.

> **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](#ID4EUB)
* [Corpo da resposta](#ID4E5B)

<a id="ID4ET" />

## Comentários

Este método HTTP/REST obtém a atividade atual dos usuários para a sessão, para os identificadores especificados. 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="ID4EUB" />

## Corpo da solicitação

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

<a id="ID4E5B" />

## Corpo da resposta

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

<a id="ID4EKC" />

## Confira também

<a id="ID4EMC" />

##### Pai

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


## Related topics

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