Téléverser les octets d’un fichier tus

Ajoute les octets bruts du fichier au décalage déclaré d’un téléversement avec reprise.

PATCH{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.

Cela envoie file (quatre octets) vers un nouveau téléversement réservé pour quatre octets, comme indiqué dans Créer un téléversement tus. Pour reprendre un transfert, récupérez d’abord le décalage du serveur et envoyez uniquement les octets restants avec ce décalage. Ne renvoyez pas le fichier entier à un décalage non nul.

Omettez Upload-Length pour un téléversement de taille fixe. Utilisez-le uniquement lorsque le téléversement a été créé avec Upload-Defer-Length: 1 et que la longueur totale n’a pas encore été déclarée. La valeur déclare la longueur totale du fichier en octets, et non la taille de ce fragment PATCH. Une fois la longueur totale déclarée, omettez Upload-Length dans les requêtes PATCH suivantes. Le fournir pour un téléversement inachevé dont la longueur est déjà connue renvoie HTTP 400.

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 PATCH --include \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --header 'tus-resumable: 1.0.0' \
  --data-binary 'file'

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 une requête PATCH tus canonique.

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

Champ	Type et description
`content-type` obligatoire	`string` (toujours : "application/offset+octet-stream")
`tus-resumable` obligatoire	`string` (toujours : "1.0.0") La version tus négociée.
`upload-length`	`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)$`
`upload-offset` 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)$`

Corps de la requête

Corps de requête binaire. application/offset+octet-stream

Réponse

HTTP 204

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
`tus-resumable` obligatoire	`string` (toujours : "1.0.0")
`upload-offset` 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)$`
`x-content-type-options` obligatoire	`string` (toujours : "nosniff")

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")