> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 los identificadores especificados por su ID de identificador.

> **Importante:**\
> Este método lo usa el multijugador de 2015 y se aplica únicamente a esa versión multijugador y posteriores. Está pensado para usarse con el contrato de plantilla 104/105 o posterior, y requiere un elemento de encabezado X-Xbl-Contract-Version: 104/105 o posterior en cada solicitud.

* [Comentarios](#ID4ET)
* [Parámetros de URI](#ID4EDB)
* [Códigos de estado HTTP](#ID4EOB)
* [Cuerpo de la solicitud](#ID4EUB)
* [Cuerpo de la respuesta](#ID4E5B)

## Comentarios

Este método HTTP/REST obtiene la actividad actual de los usuarios para la sesión, para los identificadores especificados. Lo que se devuelve es el objeto de sesión, con todos sus atributos. Este método puede encapsularse mediante **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync**.

El autor de la llamada a este método obtiene el ID de identificador del objeto **MultiplayerActivityDetails** de un jugador. Como alternativa, el autor de la llamada obtiene el ID de una activación de protocolo después de que un usuario haya aceptado una invitación a un juego.

## Parámetros de URI

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- |
\| handleId| GUID| El ID único del identificador de la sesión.|

## Códigos de estado HTTP

El servicio devuelve un código de estado HTTP según se aplica al MPSD.

## Cuerpo de la solicitud

No se envían objetos en el cuerpo de esta solicitud.

## Cuerpo de la respuesta

Consulte la estructura de la respuesta en [MultiplayerSession (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-multiplayersession.md).

## Consulte también

##### Elemento primario

[/handles/{handleId}](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleid.md)


## Related topics

- [/handles/{handleId}](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleid.md)
- [GET (/handles/{handleId}/session)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget.md)
- [/handles/{handleId}/session](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession.md)
- [DELETE (/handles/{handleId})](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleiddelete.md)
- [PUT (/handles/{handle-id}/session)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput.md)