> ## 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 (/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)

<a id="ID4EV" />

## Remarques

La réponse peut être filtrée pour fournir une partie du [PresenceRecord](/fr/reference/live/rest/json/json-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.

<a id="ID4EDB" />

## Paramètres d'URI

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

<a id="ID4EOB" />

## Paramètres de chaîne de requête

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

<a id="ID4E4C" />

## Autorisation

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

<a id="ID4EAE" />

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

<a id="ID4EVH" />

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

<a id="ID4E1BAC" />

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

<a id="ID4E1CAC" />

## Corps de la requête

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

<a id="ID4EFDAC" />

## Corps de la réponse

<a id="ID4ELDAC" />

### 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",
      }
    }]
  }]
}

```

<a id="ID4EXDAC" />

## Voir aussi

<a id="ID4EZDAC" />

##### Parent

[/users/xuid({xuid})](/fr/reference/live/rest/uri/presence/uri-usersxuid)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)