POST (/users/xuid()/outbox)

Envia uma mensagem especificada para uma lista de destinatários. O domínio desses URIs é msg.xboxlive.com.

Comentários
Parâmetros de URI
Autorização
Efeito das configurações de privacidade no recurso
Corpo da solicitação
Códigos de status HTTP
Corpo da resposta

Comentários

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

Autorização

Você deve ter sua própria declaração de usuário e uma assinatura gold válida para enviar uma mensagem de usuário.

Efeito das configurações de privacidade no recurso

Enviar com êxito uma mensagem de usuário para um jogador, seja ele amigo ou não, resulta em um código de resultado 200. No entanto, se você enviar uma mensagem para alguém que bloqueou você, o destinatário não receberá a mensagem e você não receberá nenhuma indicação de que sua mensagem não foi bem-sucedida. Também há limites para quantas mensagens podem ser enviadas por dia e para quantos amigos e não amigos, conforme a seguir.

20 desconhecidos por mensagem
200 desconhecidos a cada 24 horas
250 mensagens no total a cada 24 horas
2500 destinatários no total a cada 24 horas

| Usuário solicitante| Configuração de privacidade do usuário de destino| Comportamento| | --- | --- | --- | --- | --- | --- | | eu| -| Conforme descrito.| | amigo| todos| 200 OK| | amigo| somente amigos| 200 OK| | amigo| bloqueado| 200 OK| | usuário não amigo| todos| 200 OK| | usuário não amigo| somente amigos| 200 OK| | usuário não amigo| bloqueado| 200 OK| | site de terceiros| todos| 200 OK| | site de terceiros| somente amigos| 200 OK| | site de terceiros| bloqueado| 200 OK|

Corpo da solicitação

Propriedade	Tipo	Comprimento máximo	Consumidores	Comentários
header	Header		Todos	Cabeçalho da mensagem de usuário
messageText	string	250	Todas as plataformas, exceto Windows 8	Texto da mensagem de usuário (UTF-8)

Propriedade	Tipo	Comprimento máximo	Consumidores	Comentários
recipients	User[]	20	Todos	Lista de destinatários da mensagem

User

Propriedade	Tipo	Comprimento máximo	Consumidores	Comentários
xuid	ulong		Todos	XUID do destinatário. Não usado se o gamertag for enviado.
gamertag	string	15	Todos	Gamertag do destinatário. Não usado se a XUID for enviada.

Exemplo de corpo da solicitação

{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

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 lista de destinatários está vazia ou excede o comprimento máximo; ou gamertag e XUID foram especificados; ou messageText é muito longo.| | 403| A XUID não pode ser convertida.| | 404| O gamertag é inválido ou o usuário não pode ser encontrado.| | 409| O usuário atingiu o limite diário imposto pelo sistema.| | 500| Erro geral do lado do servidor.|

Porting

Build Paths

POST (/users/xuid({xuid})/outbox)

POST (/users/xuid()/outbox)

Comentários

Parâmetros de URI

Autorização

Efeito das configurações de privacidade no recurso

Corpo da solicitação

Header

User

Exemplo de corpo da solicitação

Códigos de status HTTP

Corpo da resposta

Confira também

Pai

Referência Códigos de status HTTP padrão

​POST (/users/xuid()/outbox)

​Comentários

​Parâmetros de URI

​Autorização

​Efeito das configurações de privacidade no recurso

​Corpo da solicitação

​Header

​User

​Exemplo de corpo da solicitação

​Códigos de status HTTP

​Corpo da resposta

​Confira também

Pai

Referência Códigos de status HTTP padrão

POST (/users/xuid()/outbox)

Comentários

Parâmetros de URI

Autorização

Efeito das configurações de privacidade no recurso

Corpo da solicitação

Header

User

Exemplo de corpo da solicitação

Códigos de status HTTP

Corpo da resposta

Confira também