> ## 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.

# POST (/users/{ownerId}/people/xuids)

> POST (/users/{ownerId}/people/xuids)

# POST (/users/{ownerId}/people/xuids)

Obtiene personas por XUID 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](#ID4EBE)
* [Cuerpo de la solicitud](#ID4EHF)
* [Códigos de estado HTTP](#ID4EKH)
* [Encabezados de respuesta obligatorios](#ID4ENBAC)
* [Cuerpo de la respuesta](#ID4EZCAC)

## Comentarios

Las operaciones POST 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}). |

## 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>**.|
\| Content-Length| Entero de 32 bits sin signo. Longitud, en bytes, del cuerpo de la solicitud. Valor de ejemplo: 22.|
\| Content-Type| Cadena. Tipo MIME del cuerpo de la solicitud. Debe ser **application/json**.|

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

### Miembros obligatorios

\| Miembro| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| Matriz de XUID que identifican las personas que se devolverán de la colección de contactos del autor de la llamada. Consulte [XuidList (JSON)](/es/reference/live/rest/json/json-xuidlist).|

### Miembros opcionales

No hay miembros opcionales para esta solicitud.

### Miembros prohibidos

Todos los demás miembros están prohibidos en una solicitud.

### Ejemplo de solicitud

```cpp theme={null}
{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      
```

## 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](/es/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| Correcto cuando el método es "get".|
\| 204| No Content| Correcto cuando el método es "add" o "remove".|
\| 400| Bad Request| El parámetro del método faltaba o tenía un formato incorrecto, o 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.|

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

Solo se envía un cuerpo de respuesta cuando el método de la solicitud es "get". No hay cuerpo de respuesta para "add" ni "remove".

Si una llamada al método "get" es correcta, el servicio devuelve el número total de personas de la colección de contactos del autor de la llamada, y una matriz que contiene la colección de contactos del autor de la llamada. No se devuelve ninguna respuesta para los métodos "add" y "remove". Consulte [PeopleList (JSON)](/es/reference/live/rest/json/json-peoplelist).

### Ejemplo de respuesta

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

## Consulte también

##### Elemento primario

[/users/{ownerId}/people/xuids](/es/reference/live/rest/uri/people/uri-usersowneridpeoplexuids)


## Related topics

- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [People System에서 사람 표시하기](/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)