Skip to main content

POST (/users/batch)

Obtient la présence d’un lot d’utilisateurs. Le domaine de ces URI est userpresence.xboxlive.com.

Remarques

Cette méthode doit être utilisée par tout client, service ou titre souhaitant obtenir des informations de présence pour un lot d’utilisateurs. Les réponses à cette requête par lot peuvent être filtrées par profondeur et par chemin. Les consommateurs peuvent s’en servir pour connaître et afficher la présence d’un ensemble d’utilisateurs. Les filtres de cette API fonctionnent comme des OU au sein d’une propriété, mais comme des ET entre les propriétés.

Autorisation

Effet des paramètres de confidentialité sur la ressource

Cette méthode retourne toujours 200 OK, mais peut ne pas retourner de contenu dans le corps de la réponse. | Utilisateur demandeur| Paramètre de confidentialité de l’utilisateur cible| Comportement| | --- | --- | --- | --- | --- | --- | --- | | moi| -| 200 OK| | ami| tout le monde| 200 OK| | ami| amis uniquement| 200 OK| | ami| bloqué| 200 OK| | utilisateur non ami| tout le monde| 200 OK| | utilisateur non ami| amis uniquement| 200 OK| | utilisateur non ami| bloqué| 200 OK| | site tiers| tout le monde| 200 OK| | site tiers| amis uniquement| 200 OK| | site tiers| bloqué| 200 OK|

En-têtes de requête obligatoires

| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Informations d’identification pour l’authentification HTTP. Exemple de valeur : “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Exemples de valeurs : 3, vnext.| | Accept| string| Types de contenu (Content-Types) acceptables. Le seul pris en charge par Presence est application/json, mais il doit être spécifié dans l’en-tête.| | Accept-Language| string| Paramètres régionaux acceptables pour les chaînes de la réponse. Exemples de valeurs : en-US.| | Host| string| Nom de domaine du serveur. Exemple de valeur : presencebeta.xboxlive.com.| | Content-Length| string| Longueur du corps de la requête. Exemple de valeur : 312.|

En-têtes de requête facultatifs

| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Valeur par défaut : 1.|

Corps de la requête

Membres obligatoires

| Membre| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | users| Liste des XUID des utilisateurs dont vous souhaitez connaître la présence, avec un maximum de 1100 XUID à la fois.|

Membres facultatifs

| Membre| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | deviceTypes| Liste des types d’appareils utilisés par les utilisateurs qui vous intéressent. Si le tableau est laissé vide, il prend par défaut tous les types d’appareils possibles (c’est-à-dire qu’aucun n’est exclu par filtrage).| | titles| Liste des types d’appareils dont les utilisateurs vous intéressent. Si le tableau est laissé vide, il prend par défaut tous les titres possibles (c’est-à-dire qu’aucun n’est exclu par filtrage).| | level| Valeurs possibles :
  • user : obtient les nœuds utilisateur
  • device : obtient les nœuds utilisateur et appareil
  • title : obtient les informations de base au niveau du titre
  • all : obtient les informations Rich Presence, les informations multimédias, ou les deux

La valeur par défaut est “title”.| | onlineOnly| Si cette propriété a la valeur true, l’opération par lot exclut les enregistrements des utilisateurs hors connexion (y compris ceux qui sont masqués). Si elle n’est pas fournie, les utilisateurs en ligne et hors connexion sont retournés.|

Membres interdits

Tous les autres membres sont interdits dans une requête.

Exemple de requête

Corps de la réponse

Exemple de réponse

Cette méthode retourne un PresenceRecord.

Voir aussi

Parent
/users/batch
Last modified on October 6, 2026