> ## 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.

# POST (/handles)

> POST (/handles)

# 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](#ID4ET)
* [Parámetros de URI](#ID4EHB)
* [Códigos de estado HTTP](#ID4EPB)
* [Cuerpo de la solicitud](#ID4EVB)
* [Cuerpo de la respuesta](#ID4EJC)

## 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

```cpp theme={null}
{
  "version": 1,
  "type": "activity",
  "sessionRef": {
    "scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
    "templateName": "deathmatch",
    // The session name is optional in a POST; if not specified, MPSD fills in a GUID.//
    "name": "session-49"
  },
}

```

### Cuerpo de la solicitud para enviar invitaciones

```cpp theme={null}
{
  // Common handle fields
  "id: "47ca0049-a5ba-4bc1-aa22-fcf834ce4c13",
  "version": 1,
  "type": "invite",
  "sessionRef": {
    "scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
    "templateName": "deathmatch",
    "name": "session-49"
   },
   "inviteAttributes": {
     "titleId" : {titleId}, // The title being invited to, in decimal uint32. This value is used to find the title name and/or image.
     "context" : {context}, // The title defined context token. Must be 256 characters or less when URI-encoded.
     "contextString" : {contextstring}, // The string name of a custom invite string to display in the invite notification.
     "senderString" : {sender} // The string name of the sender when the sender is a service.
   },
   "invitedXuid": "3210",
}

```

## 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](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handles.md)


## Related topics

- [POST (/handles/query)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesquerypost.md)
- [/handles](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handles.md)
- [/handles/query](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesquery.md)
- [POST (/handles/query?include=relatedInfo)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-handlesqueryincludepost.md)
- [PFLobbyServerPostUpdate](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)