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

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

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

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

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

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

## Corpo da solicitação

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

## 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](https://docs.xbox.com/pt-BR/reference/live/rest/additional/httpstatuscodes.md).

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

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

## Corpo da resposta

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

### Exemplo de resposta

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

## Confira também

##### Pai

[/users/{ownerId}/people/{targetid}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/people/uri-usersowneridpeopletargetid.md)


## Related topics

- [/users/{ownerId}/people/{targetid}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/people/uri-usersowneridpeopletargetid.md)
- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [/users/{ownerId}/people](https://docs.xbox.com/pt-BR/reference/live/rest/uri/people/uri-usersowneridpeople.md)
- [/users/{ownerId}/people/mute](https://docs.xbox.com/pt-BR/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemute.md)