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

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

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

<a id="ID4EV" />

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

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

<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>.|
\| 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 <b>application/json</b>.|

<a id="ID4EBE" />

## 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="ID4EHF" />

## Corpo da solicitação

<a id="ID4ENF" />

### 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)](/pt-BR/reference/live/rest/json/json-xuidlist).|

<a id="ID4EKG" />

### Membros opcionais

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

<a id="ID4EVG" />

### Membros proibidos

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

<a id="ID4EAH" />

### Exemplo de solicitação

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

<a id="ID4EKH" />

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

<a id="ID4ENBAC" />

## 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="ID4EZCAC" />

## 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)](/pt-BR/reference/live/rest/json/json-peoplelist).

<a id="ID4EHDAC" />

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

<a id="ID4ERDAC" />

## Confira também

<a id="ID4ETDAC" />

##### Pai

[/users/{ownerId}/people/xuids](/pt-BR/reference/live/rest/uri/people/uri-usersowneridpeoplexuids)


## 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)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)
- [People 시스템에서 사람 표시하기](/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)