Skip to main content

GET (/serviceconfigs//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

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 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync.
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 private et reservations, la méthode retourne un code d’erreur 403 Forbidden, que de telles sessions existent ou non.

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

Codes d’état HTTP

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

Corps de la requête

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

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.

Voir aussi

Parent
/serviceconfigs//sessions
Last modified on October 6, 2026