Transloadit

Récupérer le décalage d’un téléversement tus

Renvoie le décalage actuel en octets et les métadonnées d’un téléversement avec reprise.

HEAD{UPLOAD_URL}

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 --head \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'tus-resumable: 1.0.0'

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 HEAD tus canonique.

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

ChampType et description
tus-resumable

obligatoire

string (toujours : "1.0.0")

La version tus négociée.

Réponse

HTTP 200

Aucun corps de réponse.

En-têtes de réponse
Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

ChampType et description
cache-control

obligatoire

string (toujours : "no-store")
tus-resumable

obligatoire

string (toujours : "1.0.0")
upload-concat
"partial" | string

Soit partial, soit final; suivi d’une ou de plusieurs URL de capacité de téléversement séparées par des espaces, renvoyées lors d’une création partielle réussie. Le point-virgule après final est obligatoire.

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

string (toujours : "partial")
string
Variante 2: string
string
Motif de validation (expression régulière)^final;https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+\/resumable\/files\/[^/\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]+)*(?: https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+\/resumable\/files\/[^/\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]+)*)*$
upload-metadata
string

Clés de métadonnées et valeurs canoniques en Base64 standard séparées par des virgules, sérialisées par l’environnement d’exécution tus dont la version est fixée.

Motif de validation (expression régulière)^(?:\t|[^\u0000- ,\u007f])+(?: (?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?)?(?:,(?:\t|[^\u0000- ,\u007f])+(?: (?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?)?)*$
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")

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

propriétés requises : content-length, upload-length

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

ChampType et description
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)$
upload-defer-length
jamais

Cette valeur est interdite.

upload-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)$
upload-defer-length: "1"

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

ChampType et description
content-length
jamais

Cette valeur est interdite.

upload-defer-length

obligatoire

string (toujours : "1")
upload-length
jamais

Cette valeur est interdite.

Réponse d’erreur

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.

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