Saltar al contenido principal

POST (/handles)

Establece la sesión multijugador de la actividad actual del usuario e invita a los miembros de la sesión si es necesario.
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 puede usarse para establecer la sesión de la actividad actual. En este caso, el método puede encapsularse mediante Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync. El cuerpo de la solicitud debe definir la referencia de sesión, mediante el objeto sessionRef del archivo JSON, con el campo de tipo establecido en “activity”. No se recupera ningún cuerpo de respuesta. Para conocer las definiciones de los elementos especificados en una referencia de sesión, consulte Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference. Este método POST también puede usarse para invitar a una sesión a los usuarios especificados por los identificadores. En este caso, el método puede encapsularse mediante Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync. Este uso del método POST requiere que el cuerpo de la solicitud defina la referencia de sesión, pero con el campo de tipo establecido en “invite”. El cuerpo de la respuesta es un identificador de invitación.

Parámetros de URI

Ninguno

Códigos de estado HTTP

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

Cuerpo de la solicitud

Cuerpo de la solicitud para establecer la actividad

Cuerpo de la solicitud para enviar invitaciones

Cuerpo de la respuesta

Cuerpo de la respuesta para establecer la actividad

Ninguno.

Cuerpo de la respuesta para enviar invitaciones

Un identificador de invitación.

Consulte también

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