Skip to main content

GET (/users/xuid()/inbox)

Recupera un número especificado de resúmenes de mensajes de usuario del servicio. El dominio de estos URI es msg.xboxlive.com.

Comentarios

Un resumen de mensaje de usuario contiene solo el asunto del mensaje. Para los mensajes generados por el usuario, actualmente son los primeros 20 caracteres del texto del mensaje. Los mensajes del sistema pueden proporcionar un asunto alternativo, como “LIVE System”. Los mensajes se devuelven en el orden inverso al que se enviaron; es decir, los mensajes más recientes se devuelven primero. El único tipo de contenido que admite esta API es “application/json”, que es obligatorio en los encabezados HTTP de cada llamada.

Parámetros de URI

Parámetros de cadena de consulta

| Propiedad| Tipo| Longitud máxima| Comentarios| | --- | --- | --- | --- | --- | --- | --- | | maxItems| int| 100| Número máximo de mensajes devueltos.| | continuationToken| string| | Cadena devuelta en una llamada de enumeración anterior; se usa para continuar la enumeración.| | skipItems| int| 100| Número de mensajes que se omiten; se ignora si continuationToken está presente.|

Autorización

Debe tener su propia notificación de usuario para recuperar un resumen de mensaje de usuario.

Efecto de la configuración de privacidad en el recurso

Solo usted puede enumerar sus propios mensajes de usuario.

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| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| La solicitud se realizó correctamente.| | 400| El servicio no pudo interpretar una solicitud con formato incorrecto. Normalmente, un parámetro no válido.| | 403| La solicitud no está permitida para el usuario o el servicio.| | 404| Falta un XUID válido en el URI.| | 409| La colección subyacente cambió con respecto al token de continuación que se pasó.| | 416| El número de elementos que se van a omitir es mayor que el número de elementos disponibles.| | 500| Error general del lado servidor.|

Respuesta de notación de objetos JavaScript (JSON)

Si se llama correctamente, el servicio devuelve los datos de resultados en formato JSON.

Message

Paging Info

Respuesta de ejemplo

Respuesta de error

En caso de error, el servicio puede devolver un objeto errorResponse, que puede contener valores del entorno del servicio. | Propiedad| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource| string| Indicación del lugar donde se originó el error.| | errorCode| int| Código numérico asociado al error (puede ser null).| | errorMessage| string| Detalles del error si está configurado para mostrar detalles.|

Consulte también

Elemento primario
/users/xuid()/inbox
Referencia Códigos de estado HTTP estándar
Last modified on October 19, 2026