> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4EAB)
* [Autorisation](#ID4ENB)
* [Effet des paramètres de confidentialité sur la ressource](#ID4EYB)
* [Corps de la requête](#ID4E3F)
* [Codes d'état HTTP](#ID4ETCAC)
* [Corps de la réponse](#ID4E1EAC)

<a id="ID4EV" />

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

<a id="ID4EAB" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| xuid | entier 64 bits non signé | XBOX User ID (XUID) du joueur qui effectue la requête. |

<a id="ID4ENB" />

## Autorisation

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

<a id="ID4EYB" />

## Effet des paramètres de confidentialité sur la ressource

L'envoi réussi d'un message utilisateur à un joueur, qu'il soit 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 de l'échec de votre message.

Il existe également des limites quant au nombre de messages pouvant être envoyés par jour et 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
* 2500 destinataires au total par période de 24 heures

\| Utilisateur demandeur| Paramètre de confidentialité de l'utilisateur cible| Comportement|
\| --- | --- | --- | --- | --- | --- |
\| moi| -| Comme décrit.|
\| ami| tout le monde| 200 OK|
\| ami| amis uniquement| 200 OK|
\| ami| bloqué| 200 OK|
\| utilisateur non ami| tout le monde| 200 OK|
\| utilisateur non ami| amis uniquement| 200 OK|
\| utilisateur non ami| bloqué| 200 OK|
\| site tiers| tout le monde| 200 OK|
\| site tiers| amis uniquement| 200 OK|
\| site tiers| bloqué| 200 OK|

<a id="ID4E3F" />

## Corps de la requête

| Propriété | Type | Longueur maximale | Consommateurs | Remarques |
| - | - | - | - | - |
| header | Header | | Tous | En-tête du message utilisateur |
| messageText | string | 250 | Toutes les plateformes sauf Windows 8 | Texte du message utilisateur (UTF-8) |

#### Header

| Propriété | Type | Longueur maximale | Consommateurs | Remarques |
| - | - | - | - | - |
| recipients | User\[] | 20 | Tous | Liste des destinataires du message |

#### User

| Propriété | Type | Longueur maximale | Consommateurs | Remarques |
| - | - | - | - | - |
| xuid | ulong | | Tous | XUID du destinataire. Non utilisé si le gamertag est envoyé. |
| gamertag | string | 15 | Tous | Gamertag du destinataire. Non utilisé si le XUID est envoyé. |

#### Exemple de corps de requête

```cpp theme={null}
{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

```

<a id="ID4ETCAC" />

## 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 XBOX Live Services, consultez [Codes d'état HTTP standard](/fr/reference/live/rest/additional/httpstatuscodes).

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

<a id="ID4E1EAC" />

## Corps de la réponse

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

<a id="ID4EJFAC" />

## Voir aussi

<a id="ID4ELFAC" />

##### Parent

[/users/xuid({xuid})/outbox](/fr/reference/live/rest/uri/users/uri-usersxuidoutbox)

<a id="ID4EZFAC" />

##### Référence  [Codes d'état HTTP standard](/fr/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)