Skip to main content

POST (/users/xuid()/outbox)

Envoie un message spécifié à une liste de destinataires. Le domaine de ces URI est msg.xboxlive.com.

Remarques

Le seul type de contenu pris en charge par cette API est « application/json », qui est requis dans les en-têtes HTTP de chaque appel.

Paramètres d’URI

Autorisation

Vous devez disposer de votre propre revendication d’utilisateur et d’un abonnement Gold valide pour envoyer un message d’utilisateur.

Effet des paramètres de confidentialité sur la ressource

L’envoi réussi d’un message d’utilisateur à un joueur, qu’il soit un ami ou non, entraîne un code de résultat 200. Toutefois, si vous envoyez un message à une personne qui vous a bloqué, le destinataire ne recevra pas le message et vous ne recevrez aucune indication que votre message n’a pas abouti. Il existe également des limites quant au nombre de messages pouvant être envoyés par jour, ainsi qu’au nombre d’amis et de non-amis destinataires, comme suit.
  • 20 inconnus par message
  • 200 inconnus par période de 24 heures
  • 250 messages au total par période de 24 heures
  • 2 500 destinataires au total par période de 24 heures
| Utilisateur demandeur| Paramètre de confidentialité de l’utilisateur cible| Comportement| | --- | --- | --- | --- | --- | --- | | moi| -| Tel que décrit.| | ami| tout le monde| 200 OK| | ami| amis seulement| 200 OK| | ami| bloqué| 200 OK| | utilisateur non ami| tout le monde| 200 OK| | utilisateur non ami| amis seulement| 200 OK| | utilisateur non ami| bloqué| 200 OK| | site tiers| tout le monde| 200 OK| | site tiers| amis seulement| 200 OK| | site tiers| bloqué| 200 OK|

Corps de la requête

User

Exemple de corps de requête

Codes d’état HTTP

Le service retourne l’un des codes d’état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d’état HTTP standard utilisés avec les services XBOX Live, consultez Codes d’état HTTP standard. | Code| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| Réussite.| | 400| La liste des destinataires est vide ou dépasse la longueur maximale; ou le gamertag et le XUID ont tous deux été spécifiés; ou messageText est trop long.| | 403| Le XUID ne peut pas être converti.| | 404| Le gamertag n’est pas valide ou l’utilisateur est introuvable.| | 409| L’utilisateur a atteint la limite quotidienne imposée par le système.| | 500| Erreur générale côté serveur.|

Corps de la réponse

Aucun objet n’est envoyé dans le corps de la réponse.

Voir aussi

Parent
/users/xuid()/outbox
Référence Codes d’état HTTP standard
Last modified on October 6, 2026