> ## 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 o texto detalhado de uma mensagem de usuário específica, marcando-a como lida no serviço.
O domínio desses URIs é `msg.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EEB)
* [Autorização](#ID4ERB)
* [Corpo da solicitação](#ID4E3B)
* [Efeito das configurações de privacidade no recurso](#ID4EJC)
* [Códigos de status HTTP](#ID4EUC)
* [Resposta JSON (JavaScript Object Notation)](#ID4EUE)

<a id="ID4EV" />

## Comentários

A operação get só pode ser executada nos tipos de mensagem User, System e FriendRequest.

Este URI requer uma atualização no Xbox.com. Atualmente, o XBOX 360 não atualizará o estado de lida/não lida até que o usuário saia e entre novamente.

O único tipo de conteúdo compatível com esta API é "application/json", que é obrigatório nos cabeçalhos HTTP de cada chamada.

<a id="ID4EEB" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| xuid | inteiro de 64 bits sem sinal | A ID de usuário do XBOX (XUID) do jogador que está fazendo a solicitação. |
| messageId | string\[50] | ID da mensagem que está sendo recuperada ou excluída. |

<a id="ID4ERB" />

## Autorização

Você deve ter sua própria declaração de usuário para recuperar uma mensagem de usuário.

<a id="ID4E3B" />

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

<a id="ID4EJC" />

## Efeito das configurações de privacidade no recurso

Somente você pode recuperar suas próprias mensagens de usuário.

<a id="ID4EUC" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status nesta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, consulte [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Descrição|
\| --- | --- | --- | --- | --- |
\| 200| Êxito.|
\| 400| A XUID não pode ser convertida corretamente.|
\| 403| A XUID não pode ser convertida ou não foi possível encontrar uma declaração de XUID válida.|
\| 404| Uma XUID válida está ausente ou a ID da mensagem não pode ser encontrada ou foi analisada incorretamente.|
\| 500| Erro geral do lado do servidor ou o tipo de mensagem não é válido para GET.|

<a id="ID4EUE" />

## Resposta JSON (JavaScript Object Notation)

Se chamado com êxito, o serviço retorna os dados de resultados em formato JSON. O objeto raiz é um objeto UserMessageHeader.

#### UserMessageHeader

| Propriedade | Tipo | Comprimento máximo | Comentários |
| - | - | - | - |
| header | Header | | Objeto JSON |
| messageText | string | 256 | UTF-8 |

#### Header

| Propriedade | Tipo | Comprimento máximo | Comentários |
| - | - | - | - |
| sent | DateTime | | Data e hora em que a mensagem foi enviada. (Fornecido pelo serviço.) |
| expiration | DateTime | | Data e hora em que a mensagem expira. (Todas as mensagens têm um tempo de vida máximo, a ser determinado no futuro.) |
| messageType | string | 13 | Tipos de mensagem: User, System, FriendRequest. |
| senderXuid | ulong | | XUID do remetente. |
| sender | string | 15 | Gamertag do remetente. |
| hasAudio | bool | | Se a mensagem tem um anexo de áudio (voz). |
| hasPhoto | bool | | Se a mensagem tem um anexo de foto. |
| hasText | bool | | Se a mensagem contém texto. |

#### Exemplo de resposta

```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"
        }

```

#### Resposta de erro

Em caso de erro, o serviço pode retornar um objeto errorResponse, que pode conter valores do ambiente do serviço.

\| Propriedade| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| errorSource| string| Uma indicação de onde o erro se originou.|
\| errorCode| int| Código numérico associado ao erro (pode ser nulo).|
\| errorMessage| string| Detalhes do erro, se configurado para mostrar detalhes.|

<a id="ID4E3DAC" />

## Confira também

<a id="ID4E5DAC" />

##### Pai

[/users/xuid({xuid})/inbox](/pt-BR/reference/live/rest/uri/users/uri-usersxuidinbox)

<a id="ID4EMEAC" />

##### Referência  [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblAchievementsGetAchievementsForTitleIdAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)