​

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 renvoie une réponse 403 Forbidden. Si l’en-tête est non valide ou manquant, le service renvoie 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 le type est json. Spécifie que la réponse ne doit contenir qu’une certaine propriété/valeur 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”.| | customSelector| chaîne| Pour les fichiers de type config. Indique les nœuds virtuels personnalisés à inclure. Consultez Title Storage pour plus d’informations 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 renvoyé par la requête d’authentification. Consultez Authentification et autorisation des requêtes des services XBOX LIVE pour plus d’informations 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 renvoie 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 mal formée. Généralement un paramètre non valide.| | 401| Unauthorized | La requête nécessite une 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 pris trop de temps.| | 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 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| L’ETag est un identificateur opaque attribué par un serveur web à une version spécifique d’une ressource trouvé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 renvoie le contenu du fichier.

​

Voir aussi

Parent

/global/scids//data/,

Référence TitleBlob (JSON)