Skip to main content

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

Envía un mensaje especificado a una lista de destinatarios. El dominio de estos URI es msg.xboxlive.com.

​
Comentarios

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

​
Autorización

Debe tener su propia notificación de usuario y una suscripción gold válida para enviar un mensaje de usuario.

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

Enviar correctamente un mensaje de usuario a un jugador, tanto si ese jugador es amigo como si no, da como resultado un código de resultado de 200. Sin embargo, si envía un mensaje a alguien que le ha bloqueado, el destinatario no recibirá el mensaje y usted no recibirá ninguna indicación de que el mensaje no se envió correctamente. También hay límites en cuanto al número de mensajes que se pueden enviar por día y a cuántos amigos y no amigos, como se indica a continuación.
  • 20 desconocidos por mensaje
  • 200 desconocidos por 24 horas
  • 250 mensajes en total por 24 horas
  • 2500 destinatarios en total por 24 horas
| Usuario solicitante| Configuración de privacidad del usuario de destino| Comportamiento| | --- | --- | --- | --- | --- | --- | | yo| -| Como se describe.| | amigo| todos| 200 OK| | amigo| solo amigos| 200 OK| | amigo| bloqueado| 200 OK| | usuario no amigo| todos| 200 OK| | usuario no amigo| solo amigos| 200 OK| | usuario no amigo| bloqueado| 200 OK| | sitio de terceros| todos| 200 OK| | sitio de terceros| solo amigos| 200 OK| | sitio de terceros| bloqueado| 200 OK|

​
Cuerpo de la solicitud

​
User

​
Cuerpo de solicitud de ejemplo

​
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. | Código| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| Correcto.| | 400| La lista de destinatarios está vacía o supera la longitud máxima; o se especificaron tanto el gamertag como el XUID; o messageText es demasiado largo.| | 403| El XUID no se puede convertir.| | 404| El gamertag no es válido o no se encuentra el usuario.| | 409| El usuario ha alcanzado el límite diario impuesto por el sistema.| | 500| Error general del lado servidor.|

​
Cuerpo de la respuesta

No se envía ningún objeto en el cuerpo de la respuesta.

​
Consulte también

Elemento primario
/users/xuid()/outbox
Referencia Códigos de estado HTTP estándar
Last modified on October 19, 2026