> ## 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 (/serviceconfigs/{scid}/sessions)

> GET (/serviceconfigs/{scid}/sessions)

# GET (/serviceconfigs/{scid}/sessions)

Recupera la información de sesión especificada.

> **Importante:**\
> Este método ahora requiere un elemento de encabezado X-Xbl-Contract-Version: 104/105 o posterior en cada solicitud.

* [Comentarios](#ID4ET)
* [Parámetros de URI](#ID4EKB)
* [Códigos de estado HTTP](#ID4EXB)
* [Cuerpo de la solicitud](#ID4EAC)
* [Cuerpo de la respuesta](#ID4ELC)

## Comentarios

Este método HTTP/REST recupera la información de sesión para los filtros proporcionados. Este método puede encapsularse mediante **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsAsync**.

> **Nota:**\
> Para el multijugador de 2015, este método lo llama **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync**.

> **Nota:**\
> Cada llamada a este método debe incluir una palabra clave, un filtro de identificador de usuario de XBOX, o ambos. Si el autor de la llamada no tiene los permisos correctos para los parámetros *private* y *reservations*, el método devuelve un código de error 403 Forbidden, existan o no realmente dichas sesiones.

## Parámetros de URI

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- |
\| scid| GUID| Identificador de configuración de servicio (SCID). Parte 1 del ID de sesión.|
\| keyword| string| Una palabra clave que se usa para filtrar los resultados solo a las sesiones identificadas con esa cadena.|
\| xuid| GUID| Identificadores de usuario de XBOX de los usuarios cuyas sesiones se recuperarán. Los usuarios deben estar activos en las sesiones.|
\| reservations| string| Valor que indica si la lista de sesiones incluye las que los usuarios no han aceptado. Este parámetro solo puede establecerse en true. Esta configuración requiere que el autor de la llamada tenga acceso de nivel de servidor a la sesión, o que la notificación XUID del autor de la llamada coincida con el filtro de identificador de usuario de XBOX. |
\| inactive| string| Valor que indica si la lista de sesiones incluye las que los usuarios han aceptado pero en las que no están jugando activamente. Este parámetro solo puede establecerse en true.|
\| private| string| Valor que indica si la lista de sesiones incluye las sesiones privadas. Este parámetro solo puede establecerse en true. Solo es válido al consultar sus propias sesiones, o al consultar de servidor a servidor. Establecer este parámetro en true requiere que el autor de la llamada tenga acceso de nivel de servidor a la sesión, o que la notificación XUID del autor de la llamada coincida con el filtro de identificador de usuario de XBOX. |
\| visibility| string| Un valor de enumeración que indica el estado de visibilidad usado para filtrar los resultados. Actualmente, este parámetro solo puede establecerse en Open para incluir las sesiones abiertas. Consulte **MultiplayerSessionVisibility**.|
\| version| string| Un entero positivo que indica la versión principal de sesión, o inferior, de las sesiones que se incluirán. El valor debe ser menor o igual que la versión del contrato de la solicitud módulo 100.|
\| take| string| Un entero positivo que indica el número máximo de sesiones que se recuperará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

Lo que devuelve este método es una matriz JSON de referencias de sesión, con algunos datos de sesión incluidos en línea.

```cpp theme={null}
{
    "results": [ {
            "xuid": "9876",    // If the session was found from a xuid, that xuid.
            "startTime": "2009-06-15T13:45:30.0900000Z",
            "sessionRef": {
                "scid": "foo",
                "templateName": "bar",
                "name": "session-seven"
            },
            "accepted": 4,    // Approximate number of non-reserved members.
            "status": "active",    // or "reserved" or "inactive". This is the state of the user in the session, not the session itself. Only present if the session was found using a xuid.
            "visibility": "open",    // or "private", "visible", or "full"
            "joinRestriction": "local",    // or "followed". Only present if 'visibility' is "open" or "full" and the session has a join restriction.
            "myTurn": true,    // Not present is the same as 'false'. Only present if the session was found using a xuid.
            "keywords": [ "one", "two" ]
        }
    ]
}

```

## Consulte también

##### Elemento primario

[/serviceconfigs/{scid}/sessions](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions.md)


## Related topics

- [/serviceconfigs/{scid}/sessions](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatesget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName})](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenameget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameget.md)