Skip to main content

GET (/sessions//scids//data/,)

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
/sessions//scids//data/,
Référence TitleBlob (JSON)
Last modified on October 6, 2026