Skip to main content

​
PUT (/sessions//scids//data/,)

Charge un fichier. Les données peuvent être chargées en une seule fois, les données et les métadonnées étant alors envoyées dans un seul message, ou en plusieurs blocs, les données et les métadonnées étant alors envoyées dans une série de blocs plus petits. Seuls les fichiers de moins de quatre mégaoctets peuvent être envoyés dans un seul message. Le chargement en plusieurs blocs n’est pas pris en charge pour les données de type json. Le domaine de ces URI est titlestorage.xboxlive.com.

​
Paramètres d’URI

​
Autorisation

La requête doit inclure un en-tête d’autorisation XBOX LIVE valide. Si l’appelant n’est pas autorisé à accéder à cette ressource, le service retourne une réponse 403 Forbidden. Si l’en-tête est non valide ou manquant, le service retourne une réponse 401 Unauthorized.

​
Paramètres de chaîne de requête facultatifs

Pour les chargements en un seul message, les paramètres de chaîne de requête sont les suivants : | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Date/heure du fichier sur le client qui a chargé le fichier en dernier.| | displayName| string| Nom du fichier qui doit être affiché à l’utilisateur.| Pour les chargements en plusieurs blocs, les paramètres de chaîne de requête sont les suivants : | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Date/heure du fichier sur le client qui a chargé le fichier en dernier.| | displayName| string| Nom du fichier qui doit être affiché à l’utilisateur.| | continuationToken| string| Jeton de continuation provenant de la réponse à la requête de chargement précédente. S’il s’agit du premier bloc, il ne doit pas être spécifié. | | finalBlock| bool| Définissez sur true pour le dernier bloc du fichier. Définissez sur false pour tous les autres blocs.|

​
En-têtes de requête obligatoires

| En-tête| Valeur| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| Version du contrat d’API.| | Authorization| XBL3.0 x=[hash];[token]| Jeton d’authentification STS. STSTokenString est remplacé par le jeton retourné par la requête d’authentification. Pour plus d’informations sur la récupération d’un jeton STS et la création d’un en-tête d’autorisation, consultez Authentification et autorisation des requêtes des services XBOX LIVE.|

​
En-têtes de requête facultatifs

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | If-Match| Spécifie un ETag qui doit correspondre à un élément existant pour que l’opération s’effectue.| | If-None-Match| Spécifie un ETag qui ne doit correspondre à aucun élément existant pour que l’opération s’effectue.|

​
Corps de la requête

Le corps de la requête contient le contenu du fichier chargé. Pour les chargements en un seul message, le corps correspond à l’intégralité du contenu du fichier. Pour les chargements en plusieurs blocs, le corps correspond à la partie du fichier spécifiée dans les paramètres de chaîne 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| Expression de raison| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | La requête a réussi.| | 201| Created | L’entité a été créée.| | 400| Bad Request | Le service n’a pas pu comprendre la requête incorrecte. Il s’agit généralement d’un paramètre non valide.| | 401| Unauthorized | La requête nécessite l’authentification de l’utilisateur.| | 403| Forbidden | La requête n’est pas autorisée pour l’utilisateur ou le service.| | 404| Not Found | La ressource spécifiée est introuvable.| | 406| Not Acceptable | La version de la ressource n’est pas prise en charge.| | 408| Request Timeout | La requête a mis trop de temps à s’exécuter.| | 500| Internal Server Error | Le serveur a rencontré une condition inattendue qui l’a empêché de traiter la requête.| | 503| Service Unavailable | La requête a été limitée. Réessayez-la après la valeur client-retry en secondes (par exemple, 5 secondes plus tard).|

​
Corps de la réponse

Si l’appel est une requête en plusieurs blocs et qu’il réussit, le service retourne un jeton de continuation à transmettre avec le bloc suivant.

​
Exemple de réponse

​
Voir aussi

Parent
/sessions//scids//data/,
Last modified on October 6, 2026