> ## 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/{ownerId}/people/{targetid})

> GET (/users/{ownerId}/people/{targetid})

# GET (/users/{ownerId}/people/{targetid})

Obtient une personne par ID cible dans la collection de personnes de l'appelant.
Le domaine de ces URI est `social.xboxlive.com`.

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4E5)
* [Autorisation](#ID4EJB)
* [En-têtes de requête obligatoires](#ID4ERC)
* [En-têtes de requête facultatifs](#ID4EQD)
* [Corps de la requête](#ID4EWE)
* [Codes d'état HTTP](#ID4EBF)
* [En-têtes de réponse obligatoires](#ID4EDH)
* [Corps de la réponse](#ID4EQAAC)

## Remarques

Les opérations GET ne modifient aucune ressource; elles produisent donc les mêmes résultats, qu'elles soient exécutées une seule fois ou plusieurs fois.

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| ownerId | chaîne | Identificateur de l'utilisateur dont la ressource est consultée. Doit correspondre à l'utilisateur authentifié. Les valeurs possibles sont « me », xuid({xuid}) ou gt({gamertag}). |
| targetid | chaîne | Identificateur de l'utilisateur dont les données sont récupérées de la liste People du propriétaire, soit un ID d'utilisateur XBOX (XUID), soit un gamertag. Exemples de valeurs : xuid(2603643534573581), gt(SomeGamertag). |

## Autorisation

\| Type| Obligatoire| Description| Réponse si absent|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| oui| L'appelant possède l'ID d'utilisateur XBOX (XUID) de l'utilisateur.| 401 Unauthorized|

## En-têtes de requête obligatoires

\| En-tête| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| Chaîne. Données d'autorisation pour XBOX LIVE. Il s'agit généralement d'un jeton XSTS chiffré. Exemple de valeur : **XBL3.0 x=\<userhash>;\<token>**.|

## En-têtes de requête facultatifs

\| En-tête| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion| Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera 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.|
\| Accept| Chaîne. Types de contenu (Content-Types) que l'appelant accepte dans la réponse. Toutes les réponses sont de type **application/json**.|

## Corps de la requête

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

## Codes d'état HTTP

Le service retourne l'un des codes d'état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d'état HTTP standard utilisés avec les services XBOX Live, consultez [Codes d'état HTTP standard](https://docs.xbox.com/fr-CA/reference/live/rest/additional/httpstatuscodes.md).

\| Code| Expression de raison| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| Réussite.|
\| 400| Bad Request| Les ID d'utilisateur étaient mal formés.|
\| 403| Forbidden| La revendication XUID n'a pas pu être analysée à partir de l'en-tête d'autorisation.|
\| 404| Not Found| L'utilisateur cible est introuvable dans la liste People du propriétaire.|

## En-têtes de réponse obligatoires

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| entier non signé de 32 bits| Longueur, en octets, du corps de la réponse. Exemple de valeur : 22.|
\| Content-Type| chaîne| Type MIME du corps de la réponse. Ce sera toujours **application/json**.|

## Corps de la réponse

Si l'appel réussit, le service retourne la personne cible. Consultez [Person (JSON)](https://docs.xbox.com/fr-CA/reference/live/rest/json/json-person.md).

### Exemple de réponse

```cpp theme={null}
{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         
```

## Voir aussi

##### Parent

[/users/{ownerId}/people/{targetid}](https://docs.xbox.com/fr-CA/reference/live/rest/uri/people/uri-usersowneridpeopletargetid.md)


## Related topics

- [/users/{ownerId}/people/{targetid}](https://docs.xbox.com/fr-CA/reference/live/rest/uri/people/uri-usersowneridpeopletargetid.md)
- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/fr-CA/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/fr-CA/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [/users/{ownerId}/people](https://docs.xbox.com/fr-CA/reference/live/rest/uri/people/uri-usersowneridpeople.md)
- [/users/{ownerId}/people/avoid](https://docs.xbox.com/fr-CA/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoid.md)