Skip to main content

GET (/users/xuid())

Découvre la présence d’un autre utilisateur ou client. Le domaine de ces URI est userpresence.xboxlive.com.

Remarques

La réponse peut être filtrée pour fournir une partie du PresenceRecord si le consommateur n’est pas intéressé par l’objet entier.
Remarque :
Les données retournées sont limitées par les règles de confidentialité et d’isolation du contenu.

Paramètres d’URI

| Paramètre| Type| Description| | --- | --- | --- | --- | | xuid| entier non signé 64 bits| ID utilisateur XBOX (XUID) de l’utilisateur cible.|

Paramètres de chaîne de requête

| Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | | level| chaîne| Facultatif.
  • user : retourne uniquement le nœud utilisateur.
  • device : retourne le nœud utilisateur et les nœuds d’appareil.
  • title : valeur par défaut. Retourne l’arborescence entière, à l’exception de l’activité.
  • all : retourne l’arborescence entière, y compris la présence au niveau de l’activité.
|

Autorisation

| Type| Obligatoire| Description| Réponse en cas d’absence| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XUID| Oui| ID utilisateur XBOX (XUID) de l’appelant| 403 Forbidden|

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| chaîne| Informations d’identification d’authentification pour l’authentification HTTP. Exemple de valeur : “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| chaîne| Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est routé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| chaîne| Types de contenu acceptables. Le seul pris en charge par Presence est application/json, mais il doit être spécifié dans l’en-tête.| | Accept-Language| chaîne| Paramètres régionaux acceptables pour les chaînes de la réponse. Exemples de valeurs : en-US.| | Host| chaîne| Nom de domaine du serveur. Exemple de valeur : presencebeta.xboxlive.com.|

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 routé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

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

Corps de la réponse

Exemple de réponse

S’il n’existe aucun enregistrement pour l’utilisateur, un enregistrement sans appareil est retourné.

Voir aussi

Parent
/users/xuid()
Last modified on October 6, 2026