> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/handles)

> POST (/handles)

# POST (/handles)

Définit la session multijoueur de l'activité actuelle de l'utilisateur et invite des membres de la session si nécessaire.

> **Important :**\
> Cette méthode est utilisée par le multijoueur 2015 et s'applique uniquement à cette version multijoueur et aux versions ultérieures. Elle est destinée à être utilisée avec le contrat de modèle 104/105 ou ultérieur et nécessite un élément d'en-tête X-Xbl-Contract-Version: 104/105 ou ultérieur dans chaque requête.

* [Remarques](#ID4ET)
* [Paramètres d'URI](#ID4EHB)
* [Codes d'état HTTP](#ID4EPB)
* [Corps de la requête](#ID4EVB)
* [Corps de la réponse](#ID4EJC)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST peut être utilisée pour définir la session de l'activité actuelle. Dans ce cas, la méthode peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync**. Le corps de la requête doit définir la référence de session, au moyen de l'objet **sessionRef** dans le fichier JSON, avec le champ type défini sur « activity ». Aucun corps de réponse n'est récupéré. Pour connaître les définitions des éléments spécifiés dans une référence de session, consultez **Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference**.

Cette méthode POST peut également être utilisée pour inviter à une session les utilisateurs spécifiés par les descripteurs. Dans ce cas, la méthode peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync**. Cette utilisation de la méthode POST exige que le corps de votre requête définisse la référence de session, mais avec le champ type défini sur « invite ». Le corps de la réponse est un descripteur d'invitation.

<a id="ID4EHB" />

## Paramètres d'URI

Aucun

<a id="ID4EPB" />

## Codes d'état HTTP

Le service retourne un code d'état HTTP tel qu'il s'applique au MPSD.

<a id="ID4EVB" />

## Corps de la requête

<a id="ID4E1B" />

### Corps de la requête pour définir l'activité

```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"
  },
}

```

<a id="ID4EBC" />

### Corps de la requête pour envoyer des invitations

```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",
}

```

<a id="ID4EJC" />

## Corps de la réponse

<a id="ID4EOC" />

### Corps de la réponse pour définir l'activité

Aucun.

<a id="ID4ESC" />

### Corps de la réponse pour envoyer des invitations

Un descripteur d'invitation.

<a id="ID4EXC" />

## Voir aussi

<a id="ID4EZC" />

##### Parent

[/handles](/fr-CA/reference/live/rest/uri/sessiondirectory/uri-handles)


## Related topics

- [PFLobbyPostUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbypostupdate.md)
- [PFLobbyServerPostUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyServerPostUpdateAsServer](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdateasserver.md)