Skip to main content

​
GET (/json/users/xuid()/scids//data/,json)

Télécharge un fichier. 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

Varie selon le type d’objet blob. Les objets blob binaires ne prennent pas en charge les paramètres de requête. | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | | select| string| Utilisable uniquement lorsque type est json. Indique que la réponse ne doit contenir qu’une propriété/valeur donnée du JSON, déterminée par ce paramètre. Utilisez un “point” (.) pour spécifier des sous-propriétés et des crochets (’[’ et ’]’) pour spécifier des indices de tableau. Par exemple, “array1[4].prop2” spécifie la propriété “prop2” de l’index 4 du tableau “array1”.|

​
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.| | Range| Spécifie la plage d’octets à télécharger. Suit le format standard de l’en-tête HTTP Range.|

​
Corps de la requête

Aucun objet n’est envoyé dans le corps de cette 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).|

​
En-têtes de réponse

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| ETag est un identificateur opaque attribué par un serveur web à une version spécifique d’une ressource située à une URL. Si le contenu de la ressource à cette URL change, un nouvel ETag différent est attribué.| | Content-Range| S’il s’agissait d’un téléchargement partiel, cet en-tête spécifie la plage d’octets téléchargés.|

​
Corps de la réponse

Si l’appel réussit, le service retourne le contenu du fichier.

​
Voir aussi

Parent
/json/users/xuid()/scids//data/,json
Référence TitleBlob (JSON)
Last modified on October 6, 2026