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

# POST (/users/{ownerId}/people/xuids)

> POST (/users/{ownerId}/people/xuids)

Obtém pessoas por XUID 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](#ID4EBE)
* [Corpo da solicitação](#ID4EHF)
* [Códigos de status HTTP](#ID4EKH)
* [Cabeçalhos de resposta obrigatórios](#ID4ENBAC)
* [Corpo da resposta](#ID4EZCAC)

## Comentários

As operações POST 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}). |

## 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>**.|
\| Content-Length| Inteiro sem sinal de 32 bits. Comprimento, em bytes, do corpo da solicitação. Valor de exemplo: 22.|
\| Content-Type| String. Tipo MIME do corpo da solicitação. Deve ser **application/json**.|

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

### Membros obrigatórios

\| Membro| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| Matriz de XUIDs que identificam as pessoas a serem retornadas da coleção de pessoas do chamador. Confira [XuidList (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-xuidlist.md).|

### Membros opcionais

Não há membros opcionais para esta solicitação.

### Membros proibidos

Todos os outros membros são proibidos em uma solicitação.

### Exemplo de solicitação

```cpp theme={null}
{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      
```

## 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 quando o método é "get".|
\| 204| No Content| Êxito quando o método é "add" ou "remove".|
\| 400| Bad Request| O parâmetro do método estava ausente ou malformado, ou 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.|

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

Um corpo de resposta só é enviado quando o método da solicitação é "get". Não há corpo de resposta para "add" ou "remove".

Se uma chamada do método "get" for bem-sucedida, o serviço retornará o número total de pessoas na coleção de pessoas do chamador e uma matriz contendo a coleção de pessoas do chamador. Nenhuma resposta é retornada para os métodos "add" e "remove". Confira [PeopleList (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-peoplelist.md).

### Exemplo de resposta

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

## Confira também

### Pai

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


## Related topics

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