Saltar al contenido principal

​
POST (/handles/query)

Crea consultas de identificadores de sesión.
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

Este método HTTP/REST crea consultas solo de datos de identificadores, sin ninguna información de sesión. Puede encapsularse mediante Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetActivitiesForSocialGroupAsync. El campo de tipo del cuerpo de la solicitud para este método debe establecerse en “activity”. Los elementos del cuerpo de la respuesta se asignan directamente a las propiedades de MultiplayerActivityDetails.

​
Parámetros de URI

​
Parámetros de cadena de consulta

Una consulta puede modificarse mediante los parámetros de cadena de consulta de la tabla siguiente. | Parámetro| Tipo| Descripción| | --- | --- | --- | --- | | keyword| string| Una palabra clave, por ejemplo, “foo”, que debe encontrarse en las sesiones o plantillas para que se recuperen. | | xuid| Entero de 64 bits sin signo| El identificador de usuario de XBOX, por ejemplo, “123”, de las sesiones que se incluirán en la consulta. De forma predeterminada, el usuario debe estar activo en la sesión para que esta se incluya. | | reservations| Valor booleano| True para incluir las sesiones en las que el usuario está establecido como jugador reservado pero no se ha unido para convertirse en jugador activo. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | | inactive| Valor booleano| True para incluir las sesiones que el usuario ha aceptado pero en las que no está jugando activamente. Las sesiones en las que el usuario está “ready” pero no “active” cuentan como inactivas. | | private| Valor booleano| True para incluir las sesiones privadas. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | | visibility| string| Estado de visibilidad de las sesiones. Los valores posibles los define MultiplayerSessionVisibility. Si este parámetro se establece en “open”, la consulta debe incluir solo las sesiones abiertas. Si se establece en “private”, el parámetro private debe establecerse en true. | | version| Entero de 32 bits con signo| La versión máxima de sesión que debe incluirse. Por ejemplo, un valor de 2 especifica que solo deben incluirse las sesiones con una versión principal de sesión de 2 o inferior. El número de versión debe ser menor o igual que la versión del contrato de la solicitud módulo 100. | | take| Entero de 32 bits con signo| El número máximo de sesiones que se recuperarán. Este número debe estar entre 0 y 100. | Establecer private o reservations en true requiere acceso de nivel de servidor a la sesión. Como alternativa, estas configuraciones requieren que la notificación XUID del autor de la llamada coincida con el filtro XUID del URI. De lo contrario, se devuelve el código de estado HTTP/403, existan o no realmente dichas sesiones.

​
Códigos de estado HTTP

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

​
Cuerpo de la solicitud

Para todas las actividades del gráfico social de “favoritos” de un usuario, el cuerpo de la solicitud tiene este aspecto:

​
Cuerpo de la respuesta

Los identificadores se recuperan como una matriz de estructuras de identificador, con un ID único incrustado en cada estructura.

​
Consulte también

Elemento primario
/handles/query
Última modificación el 19 de octubre de 2026