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

Obtém o perfil de um ou mais usuários, com suporte ao People Moniker.
O domínio desses URIs é `profile.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EKB)
* [Parâmetros da cadeia de consulta](#ID4EVB)
* [Cabeçalhos de solicitação obrigatórios](#ID4EQC)
* [Corpo da solicitação](#ID4E2D)

<a id="ID4EV" />

## Comentários

**userList** e **userIds** são parâmetros mutuamente exclusivos. Se ambos ou qualquer um deles for especificado, você receberá um **BadRequest** como retorno. **userList** é uma matriz para garantir compatibilidade futura em cenários em que seja útil solicitar várias listas nomeadas. **userIds** é composto por cadeias de caracteres decimais para XUIDs, pois o JSON não é bom em serializar inteiros sem sinal de 64 bits. Por fim, as configurações no XBOX One serão configurações nomeadas, com nomes normais legíveis por humanos, em vez de inteiros sem sinal de 64 bits ou constantes obscuras como **XONLINE\_PROFILE\_ASDF**.

<a id="ID4EKB" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| userId | string | Pode ser 'xuid(12345)', 'gt(myGamertag)' ou 'me'. |
| userList | string | Uma lista nomeada de pessoas para as quais obter configurações. No momento, People é a única lista compatível. |

<a id="ID4EVB" />

## Parâmetros da cadeia de consulta

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| settings| string| Uma lista de nomes de configurações delimitada por vírgulas.|

<a id="ID4EQC" />

## Cabeçalhos de solicitação obrigatórios

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| inteiro com sinal de 32 bits| Valor = 2|
\| content-type| string| Valor = <code>application/json</code>|

<a id="ID4E2D" />

## Corpo da solicitação

<a id="ID4EBE" />

### Exemplo de solicitação

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

<a id="ID4EKE" />

<a id="ID4EME" />

##### Corpo da resposta

A resposta é um objeto **ReadMultiSettingsResponseV2**. Supondo que o usuário que faz a chamada tenha apenas um amigo:

```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" />

## Confira também

<a id="ID4E5E" />

##### Pai

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

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


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)