Skip to main content

​
POST (/users//people/xuids)

Obtém pessoas por XUID na coleção de pessoas do chamador. O domínio desses URIs é social.xboxlive.com.

​
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

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

​
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

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

​
Exemplo de resposta

​
Confira também

Pai
/users//people/xuids
Last modified on October 6, 2026