> ## 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/{userId}/profile/settings/people/{userList})

> GET (/users/{userId}/profile/settings/people/{userList})

# GET (/users/{userId}/profile/settings/people/{userList})

Obtient le profil d'un ou de plusieurs utilisateurs, avec prise en charge du moniker People.
Le domaine de ces URI est `profile.xboxlive.com`.

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4EKB)
* [Paramètres de chaîne de requête](#ID4EVB)
* [En-têtes de requête obligatoires](#ID4EQC)
* [Corps de la requête](#ID4E2D)

<a id="ID4EV" />

## Remarques

**userList** et **userIds** sont des paramètres mutuellement exclusifs. Si les deux ou l'un d'eux sont spécifiés, vous recevez une réponse **BadRequest**. **userList** est un tableau afin d'anticiper les scénarios où il est utile de demander plusieurs listes nommées. **userIds** est composé de chaînes décimales pour les XUID, car JSON sérialise mal les entiers non signés 64 bits. Enfin, les paramètres sur XBOX One seront des paramètres nommés, avec des noms normaux lisibles par l'utilisateur, plutôt que des entiers non signés 64 bits ou des constantes obscures comme **XONLINE\_PROFILE\_ASDF**.

<a id="ID4EKB" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| userId | chaîne | Peut être 'xuid(12345)', 'gt(myGamertag)' ou 'me'. |
| userList | chaîne | Liste nommée de personnes pour lesquelles obtenir les paramètres. Actuellement, People est la seule liste prise en charge. |

<a id="ID4EVB" />

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

\| Paramètre| Type| Description|
\| --- | --- | --- | --- | --- | --- |
\| settings| chaîne| Liste de noms de paramètres séparés par des virgules.|

<a id="ID4EQC" />

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

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| entier signé 32 bits| Valeur = 2|
\| content-type| chaîne| Valeur = <code>application/json</code>|

<a id="ID4E2D" />

## Corps de la requête

<a id="ID4EBE" />

### Exemple de requête

```cpp theme={null}
GET /users/me/profile/settings/people/people?settings=GameDisplayName,GameDisplayPicRaw,Gamerscore,Gamertag
      
```

<a id="ID4EKE" />

<a id="ID4EME" />

##### Corps de la réponse

La réponse est un objet **ReadMultiSettingsResponseV2**. En supposant que l'utilisateur appelant n'a qu'un seul ami :

```cpp theme={null}
{
      "profileUsers":[
         {
            "id":"2533274791381930",
            "settings":[
               {
                  "id":"GameDisplayName",
                  "value":"John Smith"
               },
               {
                  "id":"GameDisplayPicRaw",
                  "value":"http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIN0gxC2r1YECCd3mf2w1FDdmFCpSokJWa2z7xtVrlzOyVSc6pPRdWEXmYtpS2xE4F&format=png&w=64&h=64"
               },
               {
                  "id":"Gamerscore",
                  "value":"0"
               },
               {
                  "id":"Gamertag",
                  "value":"CracklierJewel9"
               }
            ]
         }
      ]
   }
         
```

<a id="ID4E3E" />

## Voir aussi

<a id="ID4E5E" />

##### Parent

[/users/{userId}/profile/settings/people/{userList}?settings={settings}](/fr/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist)

[Profile (JSON)](/fr/reference/live/rest/json/json-profile)


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](/pt-BR/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [Guest users overview](/build/core-features/common/user/users-guest-overview.md)