Skip to main content

​
POST (/users//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

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

​
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).|

​
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

​
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 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).

​
Ejemplo de respuesta

​
Consulte también

Elemento primario
/users//people/xuids
Last modified on October 19, 2026