GET (/users//people/)

Obtiene una persona por identificador de destino desde la colección de contactos del autor de la llamada. El dominio de estos URI es social.xboxlive.com.

Comentarios
Parámetros de URI
Autorización
Encabezados de solicitud obligatorios
Encabezados de solicitud opcionales
Cuerpo de la solicitud
Códigos de estado HTTP
Encabezados de respuesta obligatorios
Cuerpo de la respuesta

Comentarios

Las operaciones GET no modifican ningún recurso, por lo que se producirán los mismos resultados tanto si se ejecuta una vez como varias veces.

Parámetros de URI

Parámetro	Tipo	Descripción
ownerId	string	Identificador del usuario a cuyo recurso se accede. Debe coincidir con el usuario autenticado. Los valores posibles son “me”, xuid() o gt().
targetid	string	Identificador del usuario cuyos datos se recuperan de la lista de contactos del propietario, ya sea un identificador de usuario de XBOX (XUID) o un gamertag. Valores de ejemplo: xuid(2603643534573581), gt(SomeGamertag).

Autorización

| Tipo| Obligatorio| Descripción| Respuesta si falta| | --- | --- | --- | --- | --- | --- | --- | | XUID| sí| El autor de la llamada tiene el identificador de usuario de XBOX (XUID) del usuario.| 401 Unauthorized|

Encabezados de solicitud obligatorios

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| Cadena. Datos de autorización para XBOX LIVE. Suele ser un token XSTS cifrado. Valor de ejemplo: XBL3.0 x=<userhash>;<token>.|

Encabezados de solicitud opcionales

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| Nombre o número de compilación del servicio de XBOX LIVE al que debe dirigirse esta solicitud. La solicitud solo se enrutará a ese servicio después de verificar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.| | Accept| Cadena. Tipos de contenido que el autor de la llamada acepta en la respuesta. Todas las respuestas son application/json.|

Cuerpo de la solicitud

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

Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte Códigos de estado HTTP estándar. | Código| Frase de motivo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| Correcto.| | 400| Bad Request| Los identificadores de usuario tenían un formato incorrecto.| | 403| Forbidden| La notificación XUID no se pudo analizar a partir del encabezado de autorización.| | 404| Not Found| El usuario de destino no se encontró en la lista de contactos del propietario.|

Encabezados de respuesta obligatorios

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| Entero de 32 bits sin signo| Longitud, en bytes, del cuerpo de la respuesta. Valor de ejemplo: 22.| | Content-Type| string| Tipo MIME del cuerpo de la respuesta. Siempre será application/json.|

Cuerpo de la respuesta

Si la llamada es correcta, el servicio devuelve la persona de destino. Consulte Person (JSON).

Ejemplo de respuesta

{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         

Consulte también

Elemento primario

/users//people/

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GET (/users/{ownerId}/people/{targetid})

GET (/users//people/)

Comentarios

Parámetros de URI

Autorización

Encabezados de solicitud obligatorios

Encabezados de solicitud opcionales

Cuerpo de la solicitud

Códigos de estado HTTP

Encabezados de respuesta obligatorios

Cuerpo de la respuesta

Ejemplo de respuesta

Consulte también

Elemento primario

​GET (/users//people/)

​Comentarios

​Parámetros de URI

​Autorización

​Encabezados de solicitud obligatorios

​Encabezados de solicitud opcionales

​Cuerpo de la solicitud

​Códigos de estado HTTP

​Encabezados de respuesta obligatorios

​Cuerpo de la respuesta

​Ejemplo de respuesta

​Consulte también

Elemento primario

GET (/users//people/)

Comentarios

Parámetros de URI

Autorización

Encabezados de solicitud obligatorios

Encabezados de solicitud opcionales

Cuerpo de la solicitud

Códigos de estado HTTP

Encabezados de respuesta obligatorios

Cuerpo de la respuesta

Ejemplo de respuesta

Consulte también