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

<a id="ID4EV" />

## Remarques

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

<a id="ID4E5" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| ownerId | string | 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 | string | Identificateur de l'utilisateur dont les données sont récupérées dans la liste People du propriétaire, soit un ID utilisateur XBOX (XUID), soit un gamertag. Exemples de valeurs : xuid(2603643534573581), gt(SomeGamertag). |

<a id="ID4EJB" />

## Autorisation

\| Type| Obligatoire| Description| Réponse en cas d'absence|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| oui| L'appelant dispose de l'ID utilisateur XBOX (XUID) de l'utilisateur.| 401 Unauthorized|

<a id="ID4ERC" />

## 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 : <b>XBL3.0 x=\<userhash>;\<token></b>.|

<a id="ID4EQD" />

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

\| En-tête| 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.|
\| Accept| Chaîne. Types de contenu (Content-Types) que l'appelant accepte dans la réponse. Toutes les réponses sont au format <b>application/json</b>.|

<a id="ID4EWE" />

## Corps de la requête

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

<a id="ID4EBF" />

## 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](/fr/reference/live/rest/additional/httpstatuscodes).

\| Code| Expression de raison| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| Réussite.|
\| 400| Bad Request| Les ID 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.|

<a id="ID4EDH" />

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

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| entier non signé 32 bits| Longueur, en octets, du corps de la réponse. Exemple de valeur : 22.|
\| Content-Type| string| Type MIME du corps de la réponse. Il s'agit toujours de <b>application/json</b>.|

<a id="ID4EQAAC" />

## Corps de la réponse

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

<a id="ID4E3AAC" />

### Exemple de réponse

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

<a id="ID4EGBAC" />

## Voir aussi

<a id="ID4EIBAC" />

##### Parent

[/users/{ownerId}/people/{targetid}](/fr/reference/live/rest/uri/people/uri-usersowneridpeopletargetid)


## Related topics

- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [Privacy and permissions overview](/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)