> ## 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 du 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 sur 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, à l'aide 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 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 handles. Dans ce cas, la méthode peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync**. Cette utilisation de la méthode POST nécessite 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 handle 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 applicable 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 handle d'invitation.

<a id="ID4EXC" />

## Voir aussi

<a id="ID4EZC" />

##### Parent

[/handles](/fr/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)