> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/xuid({xuid}))

> GET (/users/xuid({xuid}))

# GET (/users/xuid({xuid}))

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

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4EDB)
* [Paramètres de chaîne de requête](#ID4EOB)
* [Autorisation](#ID4E4C)
* [Effet des paramètres de confidentialité sur la ressource](#ID4EAE)
* [En-têtes de requête obligatoires](#ID4EVH)
* [En-têtes de requête facultatifs](#ID4E1BAC)
* [Corps de la requête](#ID4E1CAC)
* [Corps de la réponse](#ID4EFDAC)

## Remarques

La réponse peut être filtrée pour fournir une partie du [PresenceRecord](https://docs.xbox.com/fr/reference/live/rest/json/json-presencerecord.md) 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. <ul><li>**user** : retourne uniquement le nœud utilisateur.</li><li>**device** : retourne le nœud utilisateur et les nœuds d'appareil.</li><li>**title** : valeur par défaut. Retourne l'arborescence entière, à l'exception de l'activité.</li><li>**all** : retourne l'arborescence entière, y compris la présence au niveau de l'activité.</li></ul> |

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

```json theme={null}
{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:W8,
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page",
      }
    }]
  }]
}

```

## Voir aussi

##### Parent

[/users/xuid({xuid})](https://docs.xbox.com/fr/reference/live/rest/uri/presence/uri-usersxuid.md)


## Related topics

- [GET (/users/xuid({xuid})/inbox)](https://docs.xbox.com/fr/reference/live/rest/uri/users/uri-usersxuidinboxget.md)
- [GET (/users/xuid({xuid})/achievements)](https://docs.xbox.com/fr/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)
- [GET (/users/xuid({xuid})/groups/{moniker} )](https://docs.xbox.com/fr/reference/live/rest/uri/presence/uri-usersxuidgroupsmonikerget.md)
- [GET (/users/xuid({xuid})/history/titles)](https://docs.xbox.com/fr/reference/live/rest/uri/titlehistory/uri-titlehistoryusersxuidhistorytitlesgetv2.md)
- [GET (/users/xuid({xuid})/scids/{scid}/stats)](https://docs.xbox.com/fr/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstatsget.md)