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

Detecta la presencia de otro usuario o cliente.
El dominio de estos URI es `userpresence.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4EDB)
* [Parámetros de cadena de consulta](#ID4EOB)
* [Autorización](#ID4E4C)
* [Efecto de la configuración de privacidad en el recurso](#ID4EAE)
* [Encabezados de solicitud obligatorios](#ID4EVH)
* [Encabezados de solicitud opcionales](#ID4E1BAC)
* [Cuerpo de la solicitud](#ID4E1CAC)
* [Cuerpo de la respuesta](#ID4EFDAC)

## Comentarios

La respuesta se puede filtrar para proporcionar parte del [PresenceRecord](/es/reference/live/rest/json/json-presencerecord) si el consumidor no está interesado en el objeto completo.

> **Nota:**\
> Los datos devueltos están limitados por las reglas de privacidad y de aislamiento de contenido.

## Parámetros de URI

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- |
\| xuid| Entero sin signo de 64 bits| Identificador de usuario de XBOX (XUID) del usuario de destino.|

## Parámetros de cadena de consulta

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- |
\| level| string| Opcional. <ul><li>**user**: devuelve solo el nodo de usuario.</li><li>**device**: devuelve el nodo de usuario y los nodos de dispositivo.</li><li>**title**: valor predeterminado. Devuelve todo el árbol excepto la actividad.</li><li>**all**: devuelve todo el árbol, incluida la presencia de nivel de actividad.</li></ul> |

## Autorización

\| Tipo| Obligatorio| Descripción| Respuesta si falta|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID| Sí| Identificador de usuario de XBOX (XUID) del autor de la llamada| 403 Prohibido|

## Efecto de la configuración de privacidad en el recurso

Este método siempre devuelve 200 OK, pero es posible que no devuelva contenido en el cuerpo de la respuesta.

\| Usuario solicitante| Configuración de privacidad del usuario de destino| Comportamiento|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| yo| -| 200 OK|
\| amigo| todos| 200 OK|
\| amigo| solo amigos| 200 OK|
\| amigo| bloqueado| 200 OK|
\| usuario no amigo| todos| 200 OK|
\| usuario no amigo| solo amigos| 200 OK|
\| usuario no amigo| bloqueado| 200 OK|
\| sitio de terceros| todos| 200 OK|
\| sitio de terceros| solo amigos| 200 OK|
\| sitio de terceros| bloqueado| 200 OK|

## Encabezados de solicitud obligatorios

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: "XBL3.0 x=\<userhash>;\<token>".|
\| x-xbl-contract-version| string| Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valores de ejemplo: 3, vnext.|
\| Accept| string| Tipos de contenido aceptables. El único que admite Presence es application/json, pero se debe especificar en el encabezado.|
\| Accept-Language| string| Configuración regional aceptable para las cadenas de la respuesta. Valores de ejemplo: en-US.|
\| Host| string| Nombre de dominio del servidor. Valor de ejemplo: presencebeta.xboxlive.com.|

## Encabezados de solicitud opcionales

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.|

## Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

## Cuerpo de la respuesta

### Respuesta de ejemplo

Si no existe ningún registro para el usuario, se devuelve un registro sin 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",
      }
    }]
  }]
}

```

## Consulte también

##### Elemento primario

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


## Related topics

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