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

> GET (/users/xuid({xuid}))

# GET (/users/xuid({xuid}))

Descobre a presença de outro usuário ou cliente.
O domínio desses URIs é `userpresence.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EDB)
* [Parâmetros da cadeia de consulta](#ID4EOB)
* [Autorização](#ID4E4C)
* [Efeito das configurações de privacidade no recurso](#ID4EAE)
* [Cabeçalhos de solicitação obrigatórios](#ID4EVH)
* [Cabeçalhos de solicitação opcionais](#ID4E1BAC)
* [Corpo da solicitação](#ID4E1CAC)
* [Corpo da resposta](#ID4EFDAC)

<a id="ID4EV" />

## Comentários

A resposta pode ser filtrada para fornecer parte do [PresenceRecord](/pt-BR/reference/live/rest/json/json-presencerecord) se o consumidor não estiver interessado no objeto inteiro.

> **Observação:**\
> Os dados retornados são restringidos pelas regras de privacidade e de isolamento de conteúdo.

<a id="ID4EDB" />

## Parâmetros de URI

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- |
\| xuid| inteiro sem sinal de 64 bits| ID de usuário do XBOX (XUID) do usuário de destino.|

<a id="ID4EOB" />

## Parâmetros da cadeia de consulta

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- |
\| level| string| Opcional. <ul><li><b>user</b>: retorna somente o nó do usuário.</li><li><b>device</b>: retorna o nó do usuário e os nós de dispositivo.</li><li><b>title</b>: padrão. Retorna a árvore inteira, exceto a atividade.</li><li><b>all</b>: retorna a árvore inteira, incluindo a presença no nível da atividade.</li></ul> |

<a id="ID4E4C" />

## Autorização

\| Tipo| Obrigatório| Descrição| Resposta se ausente|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID| Sim| ID de usuário do XBOX (XUID) do chamador| 403 Forbidden|

<a id="ID4EAE" />

## Efeito das configurações de privacidade no recurso

Este método sempre retorna 200 OK, mas pode não retornar conteúdo no corpo da resposta.

\| Usuário solicitante| Configuração de privacidade do usuário de destino| Comportamento|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| eu| -| 200 OK|
\| amigo| todos| 200 OK|
\| amigo| somente amigos| 200 OK|
\| amigo| bloqueado| 200 OK|
\| usuário não amigo| todos| 200 OK|
\| usuário não amigo| somente amigos| 200 OK|
\| usuário não amigo| bloqueado| 200 OK|
\| site de terceiros| todos| 200 OK|
\| site de terceiros| somente amigos| 200 OK|
\| site de terceiros| bloqueado| 200 OK|

<a id="ID4EVH" />

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

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| Credenciais de autenticação para autenticação HTTP. Valor de exemplo: "XBL3.0 x=\<userhash>;\<token>".|
\| x-xbl-contract-version| string| 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. Valores de exemplo: 3, vnext.|
\| Accept| string| Content-Types aceitáveis. O único compatível com Presence é application/json, mas ele deve ser especificado no cabeçalho.|
\| Accept-Language| string| Localidade aceitável para as cadeias de caracteres na resposta. Valores de exemplo: en-US.|
\| Host| string| Nome de domínio do servidor. Valor de exemplo: presencebeta.xboxlive.com.|

<a id="ID4E1BAC" />

## Cabeçalhos de solicitação opcionais

\| Cabeçalho| Tipo| 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.|

<a id="ID4E1CAC" />

## Corpo da solicitação

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

<a id="ID4EFDAC" />

## Corpo da resposta

<a id="ID4ELDAC" />

### Exemplo de resposta

Se não houver um registro existente para o usuário, será retornado um registro sem dispositivos.

```json theme={null}
{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:W8,
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page",
      }
    }]
  }]
}

```

<a id="ID4EXDAC" />

## Confira também

<a id="ID4EZDAC" />

##### Pai

[/users/xuid({xuid})](/pt-BR/reference/live/rest/uri/presence/uri-usersxuid)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)