Skip to main content

GET (/users/xuid())

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

Comentários

A resposta pode ser filtrada para fornecer parte do 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.

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

Parâmetros da cadeia de consulta

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

Autorização

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

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|

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

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

Corpo da solicitação

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

Corpo da resposta

Exemplo de resposta

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

Confira também

Pai
/users/xuid()
Last modified on October 6, 2026