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

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

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

Obtient la collection de personnes de l'appelant.
Le domaine de ces URI est `social.xboxlive.com`.

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4E5)
* [Paramètres de chaîne de requête](#ID4EJB)
* [Autorisation](#ID4ERD)
* [En-têtes de requête obligatoires](#ID4EZE)
* [En-têtes de requête facultatifs](#ID4EYF)
* [Corps de la requête](#ID4E5G)
* [Codes d'état HTTP](#ID4EJH)
* [En-têtes de réponse obligatoires](#ID4EBBAC)
* [Corps de la réponse](#ID4ENCAC)

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

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

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

| Paramètre | Type | Description |
| - | - | - |
| view | string | Retourne les personnes associées à une vue. La valeur par défaut est "all". Les valeurs possibles sont : **All** : retourne toutes les personnes de la liste People de l'utilisateur. Il s'agit de la valeur par défaut. **Favorite** : retourne toutes les personnes de la liste People de l'utilisateur qui ont l'attribut Favorite. **LegacyXboxLiveFriends** : retourne toutes les personnes de la liste People de l'utilisateur qui sont également des amis XBOX Live hérités. **Remarque :** seule la valeur **All** est prise en charge si l'utilisateur appelant est différent de l'utilisateur propriétaire. |
| startIndex | entier non signé 32 bits | Retourne les éléments à partir de l'index donné. |
| maxItems | entier non signé 32 bits | Nombre maximal de personnes à retourner à partir de la collection, en commençant à l'index de départ. Le service peut fournir une valeur par défaut si **maxItems** est absent et peut retourner moins de **maxItems** éléments (même si la dernière page de résultats n'a pas encore été retournée). |

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

## 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/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 **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/reference/live/rest/additional/httpstatuscodes.md).

| Code | Expression de raison | Description |
| - | - | - |
| 200 | OK | Réussite. |
| 400 | Bad Request | Les paramètres de requête ou 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. |

## 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 **application/json**. |

## Corps de la réponse

Si l'appel réussit, le service retourne le nombre total de personnes dans la collection de personnes de l'appelant, ainsi qu'un tableau contenant la collection de personnes de l'appelant. Consultez [PeopleList (JSON)](https://docs.xbox.com/fr/reference/live/rest/json/json-peoplelist.md).

### Exemple de réponse

```json theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFollowingCaller": false,
            "isFavorite": false
        },
    ],
    "totalCount": 3
}

```

## Voir aussi

##### Parent

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


## Related topics

- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/fr/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/fr/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/{targetid})](https://docs.xbox.com/fr/reference/live/rest/uri/people/uri-usersowneridpeopletargetidget.md)
- [XblSocialGetSocialRelationshipsAsync](https://docs.xbox.com/fr/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [/users/{ownerId}/people](https://docs.xbox.com/fr/reference/live/rest/uri/people/uri-usersowneridpeople.md)
