> ## 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}/sessions)

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

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

Récupère les informations de session spécifiées.

> **Important :**\
> Cette méthode nécessite maintenant 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](#ID4ELC)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST récupère les informations 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'ID 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 un 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'ID de session.|
\| keyword| chaîne| Un mot clé utilisé pour filtrer les résultats afin de ne conserver que les sessions identifiées par cette chaîne.|
\| xuid| GUID| ID 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 que sur 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'ID d'utilisateur XBOX. |
\| inactive| chaîne| Valeur indiquant si la liste des sessions inclut celles que les utilisateurs ont acceptées, mais auxquelles ils ne jouent pas activement. Ce paramètre ne peut être défini que sur true.|
\| private| chaîne| Valeur indiquant si la liste des sessions inclut les sessions privées. Ce paramètre ne peut être défini que sur true. Il est valide uniquement lors de l'interrogation de vos propres sessions, ou lors d'une interrogation de serveur à serveur. Définir ce paramètre sur 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'ID d'utilisateur XBOX. |
\| visibility| chaîne| Une valeur d'énumération indiquant l'état de visibilité utilisé pour filtrer les résultats. Actuellement, ce paramètre ne peut être défini que sur Open pour inclure les sessions ouvertes. Consultez <b>MultiplayerSessionVisibility</b>.|
\| version| chaîne| Un entier positif indiquant la version de session principale (ou 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| Un 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 au MPSD.

<a id="ID4EAC" />

## Corps de la requête

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

<a id="ID4ELC" />

## 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="ID4EWC" />

## Voir aussi

<a id="ID4EYC" />

##### Parent

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


## Related topics

- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory 개요](/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Visão geral do Multiplayer Session Directory](/pt-BR/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Vue d'ensemble de Multiplayer Session Directory](/fr/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Información general de Multiplayer Session Directory](/es/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)