Créer un téléversement tus

Crée une ressource de téléversement avec reprise à partir de métadonnées d’Assembly validées.

Pour un téléversement normal de taille fixe, commencez par créer une Assembly avec num_expected_upload_files défini sur le nombre de fichiers. Copiez ses valeurs assembly_ssl_url et tus_url dans l’exemple ci-dessous. Ne remplacez pas le tus_url renvoyé par le nom d’hôte général de l’API.

Cet exemple réserve quatre octets, puis téléverse le texte file. Pour un fichier réel, utilisez sa taille en octets et envoyez ses octets dans la requête PATCH.

assembly_ssl_url='<assembly_ssl_url from the creation response>'
tus_url='<tus_url from the creation response>'
assembly_metadata=$(printf %s "$assembly_ssl_url" | base64 | tr -d "\n")

curl --fail-with-body -sS --include --request POST \
  --url "$tus_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-length: 4' \
  --header "upload-metadata: assembly_url $assembly_metadata,filename ZmlsZS50eHQ=,fieldname ZmlsZQ=="

Une réponse de succès 201 renvoie l’URL de téléversement dans son en-tête location. Copiez cette URL ci-dessous. Conservez-la pour qu’un transfert interrompu puisse reprendre au décalage indiqué par le serveur.

upload_url='<Location response header>'
curl --fail-with-body -sS --request PATCH \
  --url "$upload_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --data-binary 'file'

Consultez le guide des téléversements avec reprise pour la reprise et la finalisation. Les longueurs différées, la concaténation et la syntaxe exacte des en-têtes sont décrites ci-dessous.

Pour les téléversements parallèles, créez des ressources partielles, téléversez leurs octets, puis créez une ressource finale qui les concatène. Seul le fichier final devient une entrée d’Assembly et est traité par votre Template. Définissez num_expected_upload_files sur le nombre de fichiers finaux, et non sur le nombre de ressources partielles. Incluez les métadonnées assembly_url, filename et fieldname dans chaque requête de création de ressource partielle ou finale. Avec tus-js-client, fournissez également ces champs dans metadataForPartialUploads lorsque vous utilisez parallelUploads.

N’incluez pas Upload-Concat pour un téléversement normal. Définissez-le sur partial dans chaque requête de création de ressource partielle. Une fois tous les téléversements partiels terminés, créez la ressource finale avec :

Upload-Concat: final;<PARTIAL_UPLOAD_URL_1> <PARTIAL_UPLOAD_URL_2>

Remplacez les espaces réservés par les URL Location complètes renvoyées pour les téléversements partiels. Conservez le point-virgule immédiatement après final ; séparez les URL par des espaces. Leur ordre détermine l’ordre des octets dans le fichier final.

Envoyez assembly_url dans l’en-tête Upload-Metadata avec la valeur de assembly_ssl_url encodée en Base64, provenant de la même réponse validée de l’Assembly.

Corps de requête binaire. application/offset+octet-stream Le corps est facultatif.