> ## 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/query)

> POST (/handles/query)

# POST (/handles/query)

Crée des requêtes sur les handles de session.

> **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](#ID4EDB)
* [Paramètres de chaîne de requête](#ID4EQB)
* [Codes d'état HTTP](#ID4EBF)
* [Corps de la requête](#ID4EIF)
* [Corps de la réponse](#ID4ETF)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST crée des requêtes sur les données de handle uniquement, sans aucune information de session. Elle peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetActivitiesForSocialGroupAsync**.

Le champ type du corps de la requête pour cette méthode doit être défini sur "activity". Les éléments du corps de la réponse correspondent directement aux propriétés de **MultiplayerActivityDetails**.

<a id="ID4EDB" />

## Paramètres d'URI

<a id="ID4EQB" />

## Paramètres de chaîne de requête

Une requête peut être modifiée à l'aide des paramètres de chaîne de requête du tableau suivant.

\| <b>Paramètre</b>| <b>Type</b>| <b>Description</b>|
\| --- | --- | --- | --- |
\| keyword| string| Mot clé, par exemple "foo", qui doit figurer dans les sessions ou les modèles pour qu'ils soient récupérés. |
\| xuid| entier non signé 64 bits| ID utilisateur XBOX, par exemple "123", des sessions à inclure dans la requête. Par défaut, l'utilisateur doit être actif dans la session pour que celle-ci soit incluse. |
\| reservations| boolean| True pour inclure les sessions dans lesquelles l'utilisateur est défini comme joueur réservé mais n'a pas rejoint la session pour devenir un joueur actif. Ce paramètre est utilisé uniquement lors de l'interrogation de vos propres sessions, ou lors de l'interrogation de serveur à serveur des sessions d'un utilisateur spécifique. |
\| inactive| boolean| True pour inclure les sessions que l'utilisateur a acceptées mais auxquelles il ne joue pas activement. Les sessions dans lesquelles l'utilisateur est "ready" mais pas "active" sont considérées comme inactives. |
\| private| boolean| True pour inclure les sessions privées. Ce paramètre est utilisé uniquement lors de l'interrogation de vos propres sessions, ou lors de l'interrogation de serveur à serveur des sessions d'un utilisateur spécifique. |
\| visibility| string| État de visibilité des sessions. Les valeurs possibles sont définies par <b>MultiplayerSessionVisibility</b>. Si ce paramètre est défini sur "open", la requête doit inclure uniquement les sessions ouvertes. S'il est défini sur "private", le paramètre <i>private</i> doit être défini sur true. |
\| version| entier signé 32 bits| Version de session maximale à inclure. Par exemple, une valeur de 2 indique que seules les sessions dont la version de session principale est inférieure ou égale à 2 doivent être incluses. Le numéro de version doit être inférieur ou égal à la version de contrat de la requête modulo 100. |
\| take| entier signé 32 bits| Nombre maximal de sessions à récupérer. Ce nombre doit être compris entre 0 et 100. |

Définir *private* ou *reservations* sur true nécessite un accès de niveau serveur à la session. Sinon, ces paramètres exigent que la revendication XUID de l'appelant corresponde au filtre XUID de l'URI. Dans le cas contraire, le code d'état HTTP/403 est retourné, que de telles sessions existent ou non.

<a id="ID4EBF" />

## Codes d'état HTTP

Le service retourne un code d'état HTTP applicable au MPSD.

<a id="ID4EIF" />

## Corps de la requête

Pour toutes les activités du graphe social "favorites" d'un utilisateur, le corps de la requête se présente comme suit :

```cpp theme={null}
{
  "type": "activity",
  "scid": "B5B1F71F-A328-4371-89E0-C3AD222D0E92"  // optional filter on scid
  "owners": {
    "people": {
      "moniker": "favorites",
      "monikerXuid": "3210"
    }
  }
}

```

<a id="ID4ETF" />

## Corps de la réponse

Les handles sont récupérés sous la forme d'un tableau de structures de handle, avec un ID unique incorporé dans chaque structure.

```cpp theme={null}
{
  "results": [
    {
      "id": "11111111-ebe0-42da-885f-033860a818f6",
      "type": "activity",
      "version": 1,
      "sessionRef": {
        "scid": "8dfb0100-ebe0-42da-885f-033860a818f6",
        "templateName": "party",
        "name": "e3a836aeac6f4cbe9bcab985494d3175"
      },
      "titleId": "1234567",
      "ownerXuid": "3212",
      {
        "id": "11111111-ebe0-42da-885f-033860a818f7",
      "type": "activity",
      "version": 1,
      "sessionRef": {
         "scid": "8dfb0100-ebe0-42da-885f-033860a818f6",
        "templateName": "TitleStorageTestDefault",
        "name": "795fcaa7-8377-4281-bd7e-e86c12843632"
      },
      "titleId": "1234567",
      "ownerXuid": "3212",
    }
  }]
}

```

<a id="ID4E4F" />

## Voir aussi

<a id="ID4E6F" />

##### Parent

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


## Related topics

- [Multiplayer session browse](/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [XStoreCloseProductsQueryHandle](/reference/system/xstore/functions/xstorecloseproductsqueryhandle.md)