Télécharger un téléversement tus

Télécharge les octets d’un téléversement avec reprise, y compris les réponses de plage prises en charge.

GET{UPLOAD_URL}

Note

Utilisez l’URL de capacité de téléversement provenant de l’en-tête Location de la réponse de succès de create-upload. Elle n’utilise pas les informations d’authentification implicitement disponibles associées à l’hôte API2.

Ce point de terminaison télécharge les octets reçus jusqu’à présent, même si le téléversement n’est pas terminé. Une réponse HTTP 200 ou 206 réussie ne signifie pas que le téléversement est terminé. Un téléversement pour lequel aucun octet n’a été reçu peut renvoyer HTTP 200 avec un corps vide. Pour une réponse portant sur une plage d’octets, la taille indiquée dans Content-Range est la taille actuellement stockée, et non la longueur finale déclarée du téléversement.

Avant de télécharger un téléversement complet, récupérez son décalage. Vérifiez que Upload-Length est présent et que Upload-Offset est égal à Upload-Length. Upload-Defer-Length: 1 signifie que la longueur totale est encore inconnue, donc que le transfert n’est pas terminé.

Le traitement de l’Assembly et la réussite de l’exportation sont distincts de l’achèvement de ce transfert tus. Vérifiez l’Assembly Status terminal et ses résultats avant de publier une ressource traitée.

Exemple de requête

Attribuez à UPLOAD_URL l’URL Location complète renvoyée lors de la création du téléversement tus. Gardez cette URL secrète.

curl --fail-with-body -sS --request GET \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --output './download.bin'

En-têtes de requête

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

En-têtes normalisés en minuscules pour l’extension de téléchargement de tusd.

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`if-match`	`string` (longueur minimale : 1, longueur maximale : 8192) Une étiquette d’entité ou un caractère générique auquel le téléversement doit correspondre.
`if-modified-since`	`string` (longueur minimale : 1, longueur maximale : 8192) Une date HTTP après laquelle un téléversement modifié est renvoyé.
`if-none-match`	`string` (longueur minimale : 1, longueur maximale : 8192) Une étiquette d’entité ou un caractère générique auquel le téléversement ne doit pas correspondre.
`if-range`	`string` (longueur minimale : 1, longueur maximale : 8192) Une étiquette d’entité ou une date HTTP qui rend une plage d’octets conditionnelle.
`if-unmodified-since`	`string` (longueur minimale : 1, longueur maximale : 8192) Une date HTTP après laquelle un téléversement modifié ne satisfait pas à la précondition.
`range`	`string` (longueur maximale : 8192) Une ou plusieurs plages d’octets canoniques. Motif de validation (expression régulière) `^bytes=(?:[0-9]+-[0-9]\|-[0-9]+)(?:,(?:[0-9]+-[0-9]\|-[0-9]+))*$`
`tus-resumable`	`string` (toujours : "1.0.0") La version de tus négociée lorsque le client la fournit.

Réponse

HTTP 200

Corps de réponse binaire. */*

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`accept-ranges` obligatoire	`string` (toujours : "bytes")
`content-disposition` obligatoire	`string` (longueur minimale : 1)
`content-length` obligatoire	`string` Un nombre d’octets canonique et non signé en base 10, compris dans la plage des entiers signés sur 64 bits, sans zéros de remplissage ni signe plus. Motif de validation (expression régulière) `^(?:0\|[1-9][0-9]{0,17}\|[1-8][0-9]{18}\|9[0-1][0-9]{17}\|92[0-1][0-9]{16}\|922[0-2][0-9]{15}\|9223[0-2][0-9]{14}\|92233[0-6][0-9]{13}\|922337[0-1][0-9]{12}\|92233720[0-2][0-9]{10}\|922337203[0-5][0-9]{9}\|9223372036[0-7][0-9]{8}\|92233720368[0-4][0-9]{7}\|922337203685[0-3][0-9]{6}\|9223372036854[0-6][0-9]{5}\|92233720368547[0-6][0-9]{4}\|922337203685477[0-4][0-9]{3}\|9223372036854775[0-7][0-9]{2}\|922337203685477580[0-6]\|9223372036854775807)$`
`content-type` obligatoire	`string` Motif de validation (expression régulière) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obligatoire	`string` (longueur minimale : 1)
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

HTTP 206

Corps de réponse binaire. */*

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Champ	Type et description
`accept-ranges` obligatoire	`string` (toujours : "bytes")
`content-disposition` obligatoire	`string` (longueur minimale : 1)
`content-length` obligatoire	`string` Un nombre d’octets canonique et non signé en base 10, compris dans la plage des entiers signés sur 64 bits, sans zéros de remplissage ni signe plus. Motif de validation (expression régulière) `^(?:0\|[1-9][0-9]{0,17}\|[1-8][0-9]{18}\|9[0-1][0-9]{17}\|92[0-1][0-9]{16}\|922[0-2][0-9]{15}\|9223[0-2][0-9]{14}\|92233[0-6][0-9]{13}\|922337[0-1][0-9]{12}\|92233720[0-2][0-9]{10}\|922337203[0-5][0-9]{9}\|9223372036[0-7][0-9]{8}\|92233720368[0-4][0-9]{7}\|922337203685[0-3][0-9]{6}\|9223372036854[0-6][0-9]{5}\|92233720368547[0-6][0-9]{4}\|922337203685477[0-4][0-9]{3}\|9223372036854775[0-7][0-9]{2}\|922337203685477580[0-6]\|9223372036854775807)$`
`last-modified` obligatoire	`string` (longueur minimale : 1)
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : content-range, content-type

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-range` obligatoire	`string` La plage d’octets renvoyée, bornes incluses, et la taille actuellement stockée, et non la longueur finale déclarée du téléversement. Motif de validation (expression régulière) `^bytes [0-9]+-[0-9]+\/[0-9]+$`
`content-type` obligatoire	`string` Motif de validation (expression régulière) `^[a-z]+\/[a-z0-9+.-]+$`

propriétés requises : content-type

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-range`	`jamais` Cette valeur est interdite.
`content-type` obligatoire	`string` Motif de validation (expression régulière) `^multipart\/byteranges; boundary=[0-9a-f]{60}$`

HTTP 304

Aucun corps de réponse.

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-disposition` obligatoire	`string` (longueur minimale : 1)
`last-modified` obligatoire	`string` (longueur minimale : 1)
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

HTTP 412

Aucun corps de réponse.

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-disposition` obligatoire	`string` (longueur minimale : 1)
`content-type` obligatoire	`string` Motif de validation (expression régulière) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obligatoire	`string` (longueur minimale : 1)
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

HTTP 416

Corps de la réponse au format texte. text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

"invalid range: failed to overlap\n" | "invalid range\n"

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Champ	Type et description
`content-disposition` obligatoire	`string` (longueur minimale : 1)
`content-type` obligatoire	`string` (toujours : "text/plain; charset=utf-8")
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : content-range

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-range` obligatoire	`string` La taille actuellement stockée pour une plage d’octets non satisfaite, et non la longueur finale déclarée du téléversement. Motif de validation (expression régulière) `^bytes [*]\/[0-9]+$`

Variante 2

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-range`	`jamais` Cette valeur est interdite.

Réponse d’erreur

Corps de la réponse au format texte. text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

string

N’importe lequel des schémas suivants peut s’appliquer :

Variante 1: string

string

Motif de validation (expression régulière)

^ERR_[A-Z0-9_]+: [^\r\n]*\n$

Variante 2: string

string

Mise en forme d’une erreur de hook en texte brut text/plain avec une charge utile reproduite à l’identique ; structure de type JSON, mais pas nécessairement du JSON valide.

Motif de validation (expression régulière)

^\{"error":"(?:[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]|[^\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff])*"\}$

En-têtes de réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Les champs autres que ceux répertoriés pour cet objet sont acceptés.

Champ	Type et description
`content-type` obligatoire	`string` (toujours : "text/plain; charset=utf-8")
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")