​

GET (/global/scids//data/,)

Télécharge un fichier. Le domaine de ces URI est titlestorage.xboxlive.com.

• Paramètres d’URI
• Autorisation
• Paramètres de chaîne de requête facultatifs
• 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 de chaîne de requête facultatifs

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 type est json. Spécifie que la réponse ne doit contenir qu’une certaine propriété/valeur du JSON, telle que 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”.| | customSelector| chaîne| Pour les fichiers de type config. Indique les nœuds virtuels personnalisés à inclure. Consultez Title Storage pour obtenir plus de renseignements sur les fichiers de type config.|

​

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 renseignements 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. 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| 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 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

/global/scids//data/,

Référence TitleBlob (JSON)