Saltar al contenido principal

GET (/serviceconfigs//sessiontemplates//sessions)

Recupera documentos de plantilla de sesión.
Importante:
Este método de URI requiere un elemento de encabezado X-Xbl-Contract-Version: 104/105 o posterior en cada solicitud.

Comentarios

Este método HTTP/REST recupera información de plantilla de sesión para los filtros proporcionados. Este método se puede encapsular mediante Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsAsync.
Nota:
Para 2015 Multiplayer, este método se llama mediante Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync.
Nota:
Cada llamada a este método debe incluir una palabra clave, un filtro de id. 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 Prohibido, independientemente de que dichas sesiones existan realmente o no.

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| Palabra clave que se usa para filtrar los resultados solo a las sesiones identificadas con esa cadena.| | xuid| GUID| Id. de usuario de XBOX de los usuarios para los que se recuperan las sesiones. 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 se puede establecer 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 id. 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 se puede establecer en true. | | private| string| Valor que indica si la lista de sesiones incluye sesiones privadas. Este parámetro solo se puede establecer en true. Solo es válido al consultar sus propias sesiones o al realizar consultas 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 id. de usuario de XBOX. | | visibility| string| Valor de enumeración que indica el estado de visibilidad que se usa para filtrar los resultados. Actualmente, este parámetro solo se puede establecer en Open para incluir sesiones abiertas. Consulte MultiplayerSessionVisibility. | | version| string| Entero positivo que indica la versión de sesión principal, o una inferior, de las sesiones que se van a incluir. El valor debe ser menor o igual que la versión de contrato de la solicitud módulo 100. | | take| string| Entero positivo que indica el número máximo de sesiones que se van a recuperar.|

Códigos de estado HTTP

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

Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

Cuerpo de la respuesta

El valor devuelto de este método es una matriz JSON de referencias de sesión, con algunos datos de sesión incluidos en línea.

Consulte también

Elemento primario
/serviceconfigs//sessiontemplates//sessions
Última modificación el 19 de octubre de 2026