Skip to main content

GET (/users/xuid()/inbox/)

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

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.

Parâmetros de URI

Autorização

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

Corpo da solicitação

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

Efeito das configurações de privacidade no recurso

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

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

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

Exemplo de resposta

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

Confira também

Pai
/users/xuid()/inbox
Referência Códigos de status HTTP padrão
Last modified on October 6, 2026