> ## 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/xuid({xuid})/inbox/{messageId})

> GET (/users/xuid({xuid})/inbox/{messageId})

# GET (/users/xuid({xuid})/inbox/{messageId})

Recupera el texto detallado de un mensaje de usuario concreto y lo marca como leído en el servicio.
El dominio de estos URI es `msg.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4EEB)
* [Autorización](#ID4ERB)
* [Cuerpo de la solicitud](#ID4E3B)
* [Efecto de la configuración de privacidad en el recurso](#ID4EJC)
* [Códigos de estado HTTP](#ID4EUC)
* [Respuesta de notación de objetos JavaScript (JSON)](#ID4EUE)

## Comentarios

La operación get solo se puede realizar en los tipos de mensaje User, System y FriendRequest.

Este URI requiere una actualización en Xbox.com. Actualmente, la XBOX 360 no actualizará el estado de leído o no leído hasta que el usuario cierre sesión y vuelva a iniciarla.

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ámetro | Tipo | Descripción |
| - | - | - |
| xuid | entero de 64 bits sin signo | Identificador de usuario de XBOX (XUID) del jugador que realiza la solicitud. |
| messageId | string\[50] | Identificador del mensaje que se recupera o elimina. |

## Autorización

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

## Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

## Efecto de la configuración de privacidad en el recurso

Solo usted puede recuperar 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](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes).

\| Código| Descripción|
\| --- | --- | --- | --- | --- |
\| 200| Correcto.|
\| 400| El XUID no se puede convertir correctamente.|
\| 403| El XUID no se puede convertir o no se encuentra una notificación de XUID válida.|
\| 404| Falta un XUID válido, o el identificador de mensaje no se encuentra o se analiza incorrectamente.|
\| 500| Error general del lado servidor, o el tipo de mensaje no es válido para GET.|

## Respuesta de notación de objetos JavaScript (JSON)

Si se llama correctamente, el servicio devuelve los datos de resultados en formato JSON. El objeto raíz es un objeto UserMessageHeader.

#### UserMessageHeader

| Propiedad | Tipo | Longitud máxima | Comentarios |
| - | - | - | - |
| header | Header | | Objeto JSON |
| messageText | string | 256 | UTF-8 |

#### Header

| Propiedad | Tipo | Longitud máxima | Comentarios |
| - | - | - | - |
| sent | DateTime | | Fecha y hora en que se envió el mensaje. (Proporcionadas por el servicio.) |
| expiration | DateTime | | Fecha y hora en que expira el mensaje. (Todos los mensajes tienen una duración máxima, que se determinará en el futuro.) |
| messageType | string | 13 | Tipos de mensaje: User, System, FriendRequest. |
| senderXuid | ulong | | XUID del remitente. |
| sender | string | 15 | Gamertag del remitente. |
| hasAudio | bool | | Indica si el mensaje tiene datos adjuntos de audio (voz). |
| hasPhoto | bool | | Indica si el mensaje tiene una foto adjunta. |
| hasText | bool | | Indica si el mensaje contiene texto. |

#### Respuesta de ejemplo

```cpp theme={null}
{
          "header":
          {
            "expiration":"2011-10-11T23:59:59.9999999",
            "messageType":"User",
            "senderXuid":"123456789",
            "sender":"Striker",
            "sent":"2011-05-08T17:30:00Z",
            "hasAudio":false,
            "hasPhoto":false,
            "hasText":true
          },
        "messageText":"random user text up to 256 characters"
        }

```

#### 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({xuid})/inbox](https://devdocs.xbox.com/es/reference/live/rest/uri/users/uri-usersxuidinbox)

##### Referencia  [Códigos de estado HTTP estándar](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblAchievementsGetAchievementsForTitleIdAsync](https://devdocs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)