Skip to main content

GET (/users/xuid()/inbox)

Recupera um número especificado de resumos de mensagens de usuário do serviço. O domínio desses URIs é msg.xboxlive.com.

Comentários

Um resumo de mensagem de usuário contém apenas o assunto da mensagem. Para mensagens geradas pelo usuário, atualmente são os primeiros 20 caracteres do texto da mensagem. Mensagens do sistema podem fornecer um assunto alternativo, como “LIVE System”. As mensagens são retornadas na ordem inversa em que foram enviadas; ou seja, as mensagens mais recentes são retornadas primeiro. 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

Parâmetros da cadeia de consulta

| Propriedade| Tipo| Comprimento máximo| Comentários| | --- | --- | --- | --- | --- | --- | --- | | maxItems| int| 100| Número máximo de mensagens retornadas.| | continuationToken| string| | Cadeia de caracteres retornada em uma chamada de enumeração anterior; usada para continuar a enumeração.| | skipItems| int| 100| Número de mensagens a serem ignoradas; ignorado se continuationToken estiver presente.|

Autorização

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

Efeito das configurações de privacidade no recurso

Somente você pode enumerar 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| A solicitação foi bem-sucedida.| | 400| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.| | 403| A solicitação não é permitida para o usuário ou serviço.| | 404| Uma XUID válida está ausente no URI.| | 409| A coleção subjacente foi alterada com base no token de continuação que foi passado.| | 416| O número de itens a serem ignorados é maior que o número de itens disponíveis.| | 500| Erro geral do lado do servidor.|

Resposta JSON (JavaScript Object Notation)

Se chamado com êxito, o serviço retorna os dados de resultados em formato JSON.

Message

Informações de paginação

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