Skip to main content

GET (/users/xuid()/inbox)

Récupère un nombre spécifié de résumés de messages d’utilisateur à partir du service. Le domaine de ces URI est msg.xboxlive.com.

Remarques

Un résumé de message d’utilisateur contient uniquement l’objet du message. Pour les messages générés par l’utilisateur, il s’agit actuellement des 20 premiers caractères du texte du message. Les messages système peuvent fournir un autre objet, comme « LIVE System ». Les messages sont retournés dans l’ordre inverse de leur envoi; autrement dit, les messages les plus récents sont retournés en premier. 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

Paramètres de chaîne de requête

| Propriété| Type| Longueur maximale| Remarques| | --- | --- | --- | --- | --- | --- | --- | | maxItems| int| 100| Nombre maximal de messages retournés.| | continuationToken| string| | Chaîne retournée lors d’un appel d’énumération précédent; utilisée pour poursuivre l’énumération.| | skipItems| int| 100| Nombre de messages à ignorer; ignoré si continuationToken est présent.|

Autorisation

Vous devez disposer de votre propre revendication d’utilisateur pour récupérer un résumé de message d’utilisateur.

Effet des paramètres de confidentialité sur la ressource

Vous seul pouvez énumérer vos propres messages d’utilisateur.

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| La requête a réussi.| | 400| Le service n’a pas pu comprendre la requête mal formée. Il s’agit généralement d’un paramètre non valide.| | 403| La requête n’est pas autorisée pour l’utilisateur ou le service.| | 404| Un XUID valide est manquant dans l’URI.| | 409| La collection sous-jacente a changé en fonction du jeton de continuation transmis.| | 416| Le nombre d’éléments à ignorer est supérieur au nombre d’éléments disponibles.| | 500| Erreur générale côté serveur.|

Réponse JSON (JavaScript Object Notation)

Si l’appel réussit, le service retourne les données de résultats au format JSON.

Message

Informations de pagination

Exemple de réponse

Réponse d’erreur

En cas d’erreur, le service peut retourner un objet errorResponse, qui peut contenir des valeurs provenant de l’environnement du service. | Propriété| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | errorSource| string| Indication de l’origine de l’erreur.| | errorCode| int| Code numérique associé à l’erreur (peut être null).| | errorMessage| string| Détails de l’erreur si la configuration permet d’afficher les détails.|

Voir aussi

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