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

# GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)

> GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)

# GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)

Récupère les documents de modèle de session.

> **Important :**\
> Cette méthode d'URI exige 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](#ID4EKB)
* [Codes d'état HTTP](#ID4EXB)
* [Corps de la requête](#ID4EAC)
* [Corps de la réponse](#ID4EKC)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST récupère les informations de modèle de session pour les filtres fournis. Cette méthode peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsAsync**.

> **Remarque :**\
> Pour le multijoueur 2015, cette méthode est appelée par <b>Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync</b>.

> **Remarque :**\
> Chaque appel à cette méthode doit inclure un mot clé, un filtre d'identifiant d'utilisateur XBOX, ou les deux. Si l'appelant ne dispose pas des autorisations appropriées pour les paramètres <i>private</i> et <i>reservations</i>, la méthode retourne le code d'erreur 403 Forbidden, que de telles sessions existent ou non.

<a id="ID4EKB" />

## Paramètres d'URI

\| Paramètre| Type| Description|
\| --- | --- | --- | --- | --- | --- |
\| scid| GUID| Identificateur de configuration de service (SCID). Partie 1 de l'identifiant de session.|
\| keyword| chaîne| Mot clé utilisé pour filtrer les résultats afin de n'inclure que les sessions identifiées par cette chaîne.|
\| xuid| GUID| Identifiants d'utilisateur XBOX des utilisateurs pour lesquels récupérer les sessions. Les utilisateurs doivent être actifs dans les sessions. |
\| reservations| chaîne| Valeur indiquant si la liste des sessions inclut celles que les utilisateurs n'ont pas acceptées. Ce paramètre ne peut être défini qu'à true. Ce paramètre exige que l'appelant dispose d'un accès de niveau serveur à la session, ou que la revendication XUID de l'appelant corresponde au filtre d'identifiant d'utilisateur XBOX. |
\| inactive| chaîne| Valeur indiquant si la liste des sessions inclut celles que les utilisateurs ont acceptées, mais dans lesquelles ils ne jouent pas activement. Ce paramètre ne peut être défini qu'à true. |
\| private| chaîne| Valeur indiquant si la liste des sessions inclut les sessions privées. Ce paramètre ne peut être défini qu'à true. Il n'est valide que lorsque vous interrogez vos propres sessions ou lors d'une requête de serveur à serveur. Définir ce paramètre à true exige que l'appelant dispose d'un accès de niveau serveur à la session, ou que la revendication XUID de l'appelant corresponde au filtre d'identifiant d'utilisateur XBOX. |
\| visibility| chaîne| Valeur d'énumération indiquant l'état de visibilité utilisé pour filtrer les résultats. Actuellement, ce paramètre ne peut être défini qu'à Open pour inclure les sessions ouvertes. Voir <b>MultiplayerSessionVisibility</b>. |
\| version| chaîne| Entier positif indiquant la version principale de session, ou une version inférieure, des sessions à inclure. La valeur doit être inférieure ou égale à la version de contrat de la requête modulo 100. |
\| take| chaîne| Entier positif indiquant le nombre maximal de sessions à récupérer.|

<a id="ID4EXB" />

## Codes d'état HTTP

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

<a id="ID4EAC" />

## Corps de la requête

Aucun objet n'est envoyé dans le corps de cette requête.

<a id="ID4EKC" />

## Corps de la réponse

Cette méthode retourne un tableau JSON de références de session, avec certaines données de session incluses directement.

```cpp theme={null}
{
    "results": [ {
            "xuid": "9876",    // If the session was found from a xuid, that xuid.
            "startTime": "2009-06-15T13:45:30.0900000Z",
            "sessionRef": {
                "scid": "foo",
                "templateName": "bar",
                "name": "session-seven"
            },
            "accepted": 4,    // Approximate number of non-reserved members.
            "status": "active",    // or "reserved" or "inactive". This is the state of the user in the session, not the session itself. Only present if the session was found using a xuid.
            "visibility": "open",    // or "private", "visible", or "full"
            "joinRestriction": "local",    // or "followed". Only present if 'visibility' is "open" or "full" and the session has a join restriction.
            "myTurn": true,    // Not present is the same as 'false'. Only present if the session was found using a xuid.
            "keywords": [ "one", "two" ]
        }
    ]
}

```

<a id="ID4EUC" />

## Voir aussi

<a id="ID4EWC" />

##### Parent

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](/fr-CA/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions)


## Related topics

- [XblMultiplayerSessionReferenceUri](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)
- [Multiplayer Session Directory 개요](/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerSessionReferenceCreate](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionreferencecreate.md)