> ## 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/{ownerId}/people/{targetid})

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

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

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](#ID4EV)
* [Parámetros de URI](#ID4E5)
* [Autorización](#ID4EJB)
* [Encabezados de solicitud obligatorios](#ID4ERC)
* [Encabezados de solicitud opcionales](#ID4EQD)
* [Cuerpo de la solicitud](#ID4EWE)
* [Códigos de estado HTTP](#ID4EBF)
* [Encabezados de respuesta obligatorios](#ID4EDH)
* [Cuerpo de la respuesta](#ID4EQAAC)

## 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({xuid}) o gt({gamertag}). |
| 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](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes).

\| 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)](https://devdocs.xbox.com/es/reference/live/rest/json/json-person).

### Ejemplo de respuesta

```cpp theme={null}
{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         
```

## Consulte también

##### Elemento primario

[/users/{ownerId}/people/{targetid}](https://devdocs.xbox.com/es/reference/live/rest/uri/people/uri-usersowneridpeopletargetid)


## Related topics

- [Displaying people from the People System](https://devdocs.xbox.com/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [Privacy and permissions overview](https://devdocs.xbox.com/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)