Skip to main content

GET (/users/xuid())

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

Comentarios

La respuesta se puede filtrar para proporcionar parte del 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.
  • user: devuelve solo el nodo de usuario.
  • device: devuelve el nodo de usuario y los nodos de dispositivo.
  • title: valor predeterminado. Devuelve todo el árbol excepto la actividad.
  • all: devuelve todo el árbol, incluida la presencia de nivel de actividad.
|

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.

Consulte también

Elemento primario
/users/xuid()
Last modified on October 19, 2026