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

Obtém uma pessoa pela ID de destino na coleção de pessoas do chamador.
O domínio desses URIs é `social.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4E5)
* [Autorização](#ID4EJB)
* [Cabeçalhos de solicitação obrigatórios](#ID4ERC)
* [Cabeçalhos de solicitação opcionais](#ID4EQD)
* [Corpo da solicitação](#ID4EWE)
* [Códigos de status HTTP](#ID4EBF)
* [Cabeçalhos de resposta obrigatórios](#ID4EDH)
* [Corpo da resposta](#ID4EQAAC)

<a id="ID4EV" />

## Comentários

As operações GET não modificam nenhum recurso, portanto produzirão os mesmos resultados se forem executadas uma ou várias vezes.

<a id="ID4E5" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| ownerId | string | Identificador do usuário cujo recurso está sendo acessado. Deve corresponder ao usuário autenticado. Os valores possíveis são "me", xuid({xuid}) ou gt({gamertag}). |
| targetid | string | Identificador do usuário cujos dados estão sendo recuperados da lista de Pessoas do proprietário, seja uma ID de usuário do XBOX (XUID) ou um gamertag. Valores de exemplo: xuid(2603643534573581), gt(SomeGamertag). |

<a id="ID4EJB" />

## Autorização

\| Tipo| Obrigatório| Descrição| Resposta se ausente|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| sim| O chamador tem a ID de usuário do XBOX (XUID) do usuário.| 401 Unauthorized|

<a id="ID4ERC" />

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

\| Cabeçalho| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| String. Dados de autorização para o XBOX LIVE. Normalmente, é um token XSTS criptografado. Valor de exemplo: <b>XBL3.0 x=\<userhash>;\<token></b>.|

<a id="ID4EQD" />

## Cabeçalhos de solicitação opcionais

\| Cabeçalho| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion| Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação e assim por diante. Valor padrão: 1.|
\| Accept| String. Content-Types que o chamador aceita na resposta. Todas as respostas são <b>application/json</b>.|

<a id="ID4EWE" />

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

<a id="ID4EBF" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os Serviços do XBOX Live, confira [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| Êxito.|
\| 400| Bad Request| As IDs de usuário estavam malformadas.|
\| 403| Forbidden| Não foi possível analisar a declaração de XUID do cabeçalho de autorização.|
\| 404| Not Found| O usuário de destino não foi encontrado na lista de Pessoas do proprietário.|

<a id="ID4EDH" />

## Cabeçalhos de resposta obrigatórios

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| inteiro sem sinal de 32 bits| Comprimento, em bytes, do corpo da resposta. Valor de exemplo: 22.|
\| Content-Type| string| Tipo MIME do corpo da resposta. Sempre será <b>application/json</b>.|

<a id="ID4EQAAC" />

## Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará a pessoa de destino. Confira [Person (JSON)](/pt-BR/reference/live/rest/json/json-person).

<a id="ID4E3AAC" />

### Exemplo de resposta

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

<a id="ID4EGBAC" />

## Confira também

<a id="ID4EIBAC" />

##### Pai

[/users/{ownerId}/people/{targetid}](/pt-BR/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)