> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

Obtiene la colección de personas del autor de la llamada.
El dominio de estos URI es `social.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4E5)
* [Parámetros de cadena de consulta](#ID4EJB)
* [Autorización](#ID4ERD)
* [Encabezados de solicitud obligatorios](#ID4EZE)
* [Encabezados de solicitud opcionales](#ID4EYF)
* [Cuerpo de la solicitud](#ID4E5G)
* [Códigos de estado HTTP](#ID4EJH)
* [Encabezados de respuesta obligatorios](#ID4EBBAC)
* [Cuerpo de la respuesta](#ID4ENCAC)

## Comentarios

Las operaciones GET no modifican ningún recurso, por lo que producirán los mismos resultados si se ejecutan una o 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}). |

## Parámetros de cadena de consulta

| Parámetro | Tipo | Descripción |
| - | - | - |
| view | string | Devuelve las personas asociadas a una vista. El valor predeterminado es "all". Los valores posibles son: **All**: devuelve todas las personas de la lista de personas del usuario. Este es el valor predeterminado. **Favorite**: devuelve todas las personas de la lista de personas del usuario que tienen el atributo Favorite. **LegacyXboxLiveFriends**: devuelve todas las personas de la lista de personas del usuario que también son amigos de XBOX Live heredados. **Nota:** Solo se admite el valor **All** si el usuario que realiza la llamada es distinto del usuario propietario. |
| startIndex | Entero de 32 bits sin signo | Devuelve los elementos a partir del índice indicado. |
| maxItems | Entero de 32 bits sin signo | Número máximo de personas que se devuelven de la colección a partir del índice inicial. El servicio puede proporcionar un valor predeterminado si **maxItems** no está presente y puede devolver menos de **maxItems** (aunque todavía no se haya devuelto la última página de resultados). |

## Autorización

| Tipo | Obligatorio | Descripción | Respuesta si falta |
| - | - | - | - |
| XUID | sí | El autor de la llamada tiene el id. 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. Normalmente es 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 se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio tras comprobar 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://docs.xbox.com/es/reference/live/rest/additional/httpstatuscodes.md).

| Código | Frase de motivo | Descripción |
| - | - | - |
| 200 | OK | Correcto. |
| 400 | Bad Request | Los parámetros de consulta o los id. de usuario tenían un formato incorrecto. |
| 403 | Forbidden | No se pudo analizar la notificación de XUID del encabezado de autorización. |

## 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 se realiza correctamente, el servicio devuelve el número total de personas de la colección de personas del autor de la llamada y una matriz que contiene la colección de personas del autor de la llamada. Consulte [PeopleList (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-peoplelist.md).

### Ejemplo de respuesta

```json theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFollowingCaller": false,
            "isFavorite": false
        },
    ],
    "totalCount": 3
}

```

## Consulte también

##### Elemento primario

[/users/\{ownerId}/people](https://docs.xbox.com/es/reference/live/rest/uri/people/uri-usersowneridpeople.md)


## Related topics

- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/es/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/es/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [GET (/users/{ownerId}/people/{targetid})](https://docs.xbox.com/es/reference/live/rest/uri/people/uri-usersowneridpeopletargetidget.md)
- [XblSocialGetSocialRelationshipsAsync](https://docs.xbox.com/es/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [/users/{ownerId}/people](https://docs.xbox.com/es/reference/live/rest/uri/people/uri-usersowneridpeople.md)
