​

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
• Paramètres facultatifs de la chaîne de requête
• En-têtes de requête obligatoires
• En-têtes de requête facultatifs
• Corps de la requête
• Codes d’état HTTP
• En-têtes de réponse
• Corps de la réponse

​

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

Varie selon le type de blob. Les blobs binaires ne prennent pas en charge les paramètres de requête. | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | | select| chaîne| Utilisable uniquement lorsque le type est json. Indique que la réponse doit contenir uniquement une propriété/valeur précise 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. 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.| | Range| Spécifie la plage d’octets à télécharger. Respecte 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| 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).|

​

En-têtes de réponse

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| L’ETag est un identificateur opaque attribué par un serveur Web à une version précise 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)