Skip to main content

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

Téléverse un fichier. Les données peuvent être téléversées en un téléversement complet, dans lequel les données et les métadonnées sont envoyées en un seul message, ou en un téléversement multibloc, dans lequel les données et les métadonnées sont envoyées en une série de blocs plus petits. Seuls les fichiers de moins de quatre mégaoctets peuvent être envoyés en un seul message. Le téléversement multibloc 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 absent, le service retourne une réponse 401 Unauthorized.

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

Pour les téléversements en un seul message, les paramètres de la chaîne de requête sont les suivants : | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Date et heure du fichier sur le client qui a téléversé le fichier en dernier.| | displayName| chaîne| Nom du fichier à afficher à l’utilisateur.| Pour les téléversements multiblocs, les paramètres de la chaîne de requête sont les suivants : | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Date et heure du fichier sur le client qui a téléversé le fichier en dernier.| | displayName| chaîne| Nom du fichier à afficher à l’utilisateur.| | continuationToken| chaîne| Jeton de continuation provenant de la réponse à la requête de téléversement précédente. S’il s’agit du premier bloc, ce paramètre ne doit pas être spécifié. | | finalBlock| booléen| Définissez la valeur true pour le dernier bloc du fichier. Définissez la valeur 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. Consultez Authentification et autorisation des requêtes des services XBOX LIVE pour obtenir des informations supplémentaires sur la récupération d’un jeton STS et la création d’un en-tête d’autorisation.|

​
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 terminer l’opération.| | If-None-Match| Spécifie un ETag qui ne doit correspondre à aucun élément existant pour terminer l’opération.|

​
Corps de la requête

Le corps de la requête contient le contenu du fichier en cours de téléversement. Pour les téléversements en un seul message, le corps correspond au contenu complet du fichier. Pour les téléversements multiblocs, le corps correspond à la partie du fichier spécifiée dans les paramètres de la 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| Phrase de motif| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | La requête a réussi.| | 201| Créé | L’entité a été créée.| | 400| Requête incorrecte | 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.| | 401| Non autorisé | La requête nécessite l’authentification de l’utilisateur.| | 403| Interdit | La requête n’est pas autorisée pour l’utilisateur ou le service.| | 404| Introuvable | La ressource spécifiée est introuvable.| | 406| Non acceptable | La version de la ressource n’est pas prise en charge.| | 408| Délai d’attente de la requête dépassé | La requête a pris trop de temps à s’exécuter.| | 500| Erreur interne du serveur | Le serveur a rencontré une condition inattendue qui l’a empêché de traiter la requête.| | 503| Service non disponible | La requête a été limitée; réessayez la requête après la valeur client-retry en secondes (p. ex. 5 secondes plus tard).|

​
Corps de la réponse

Si l’appel est une requête multibloc 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