tus-Upload herunterladen

Lädt die Bytes eines fortsetzbaren Uploads einschließlich unterstützter Bereichsantworten herunter.

GET{UPLOAD_URL}

Hinweis

Verwenden Sie die Upload-Capability-URL aus dem Location-Header der erfolgreichen create-upload-Antwort. Sie verwendet keine implizit verfügbaren Zugangsdaten des API2-Hosts.

Dieser Endpunkt lädt die bisher empfangenen Bytes herunter, auch wenn ein Upload noch nicht abgeschlossen ist. Eine erfolgreiche HTTP-Antwort mit 200 oder 206 bedeutet nicht, dass der Upload abgeschlossen ist. Ein Upload, für den noch keine Bytes empfangen wurden, kann HTTP 200 mit einem leeren Antwort-Body zurückgeben. Bei einer Bereichsantwort ist die Größe in Content-Range die aktuell gespeicherte Größe, nicht die angegebene endgültige Upload-Länge.

Bevor Sie einen vollständigen Upload herunterladen, rufen Sie dessen Offset ab. Prüfen Sie, ob Upload-Length vorhanden ist und Upload-Offset gleich Upload-Length ist. Upload-Defer-Length: 1 bedeutet, dass die Gesamtlänge noch unbekannt ist, die Übertragung also noch nicht abgeschlossen ist.

Der Abschluss dieser tus-Übertragung ist von der Verarbeitung der Assembly und dem Erfolg des Exports zu unterscheiden. Prüfen Sie den abschließenden Assembly Status und dessen Ergebnisse, bevor Sie ein verarbeitetes Asset veröffentlichen.

Anfragebeispiel

Setzen Sie UPLOAD_URL auf die vollständige Location-URL, die beim Erstellen des tus-Uploads zurückgegeben wurde. Halten Sie diese URL geheim.

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

Request-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Normalisierte kleingeschriebene Header für die Download-Erweiterung von tusd.

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`if-match`	`string` (minimale Länge: 1, maximale Länge: 8192) Ein Entity-Tag oder Platzhalter, mit dem der Upload übereinstimmen muss.
`if-modified-since`	`string` (minimale Länge: 1, maximale Länge: 8192) Ein HTTP-Datum, nach dem ein geänderter Upload zurückgegeben wird.
`if-none-match`	`string` (minimale Länge: 1, maximale Länge: 8192) Ein Entity-Tag oder Platzhalter, mit dem der Upload nicht übereinstimmen darf.
`if-range`	`string` (minimale Länge: 1, maximale Länge: 8192) Ein Entity-Tag oder HTTP-Datum, das einen Bytebereich bedingt.
`if-unmodified-since`	`string` (minimale Länge: 1, maximale Länge: 8192) Ein HTTP-Datum, nach dem ein geänderter Upload die Vorbedingung nicht erfüllt.
`range`	`string` (maximale Länge: 8192) Ein oder mehrere kanonische Bytebereiche. Validierungsmuster (regulärer Ausdruck) `^bytes=(?:[0-9]+-[0-9]\|-[0-9]+)(?:,(?:[0-9]+-[0-9]\|-[0-9]+))*$`
`tus-resumable`	`string` (immer: "1.0.0") Die ausgehandelte tus-Version, sofern der Client sie angibt.

Antwort

HTTP 200

Binärer Response-Body. */*

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`accept-ranges` erforderlich	`string` (immer: "bytes")
`content-disposition` erforderlich	`string` (minimale Länge: 1)
`content-length` erforderlich	`string` Eine kanonische vorzeichenlose Byteanzahl zur Basis 10 im vorzeichenbehafteten 64-Bit-Bereich, ohne führende Nullen oder Pluszeichen. Validierungsmuster (regulärer Ausdruck) `^(?: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` erforderlich	`string` Validierungsmuster (regulärer Ausdruck) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` erforderlich	`string` (minimale Länge: 1)
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

HTTP 206

Binärer Response-Body. */*

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Feld	Typ und Beschreibung
`accept-ranges` erforderlich	`string` (immer: "bytes")
`content-disposition` erforderlich	`string` (minimale Länge: 1)
`content-length` erforderlich	`string` Eine kanonische vorzeichenlose Byteanzahl zur Basis 10 im vorzeichenbehafteten 64-Bit-Bereich, ohne führende Nullen oder Pluszeichen. Validierungsmuster (regulärer Ausdruck) `^(?: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` erforderlich	`string` (minimale Länge: 1)
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: content-range, content-type

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-range` erforderlich	`string` Der zurückgegebene Bytebereich einschließlich beider Grenzen und die aktuell gespeicherte Größe, nicht die deklarierte endgültige Upload-Länge. Validierungsmuster (regulärer Ausdruck) `^bytes [0-9]+-[0-9]+\/[0-9]+$`
`content-type` erforderlich	`string` Validierungsmuster (regulärer Ausdruck) `^[a-z]+\/[a-z0-9+.-]+$`

erforderliche Eigenschaften: content-type

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-range`	`nie` Dieser Wert ist unzulässig.
`content-type` erforderlich	`string` Validierungsmuster (regulärer Ausdruck) `^multipart\/byteranges; boundary=[0-9a-f]{60}$`

HTTP 304

Kein Response-Body.

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-disposition` erforderlich	`string` (minimale Länge: 1)
`last-modified` erforderlich	`string` (minimale Länge: 1)
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

HTTP 412

Kein Response-Body.

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-disposition` erforderlich	`string` (minimale Länge: 1)
`content-type` erforderlich	`string` Validierungsmuster (regulärer Ausdruck) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` erforderlich	`string` (minimale Länge: 1)
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

HTTP 416

Antworttext. text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

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

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Feld	Typ und Beschreibung
`content-disposition` erforderlich	`string` (minimale Länge: 1)
`content-type` erforderlich	`string` (immer: "text/plain; charset=utf-8")
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: content-range

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-range` erforderlich	`string` Die aktuell gespeicherte Größe bei einem nicht erfüllbaren Bytebereich, nicht die deklarierte endgültige Upload-Länge. Validierungsmuster (regulärer Ausdruck) `^bytes [*]\/[0-9]+$`

Variante 2

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-range`	`nie` Dieser Wert ist unzulässig.

Fehlerantwort

Antworttext. text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

string

Eines der folgenden Schemas kann gelten:

Variante 1: string

string

Validierungsmuster (regulärer Ausdruck)

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

Variante 2: string

string

Unverändertes text/plain-Fehlerformat eines Hooks mit wörtlich übernommener Nutzlast; JSON-ähnlich, aber nicht zwingend gültiges JSON.

Validierungsmuster (regulärer Ausdruck)

^\{"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])*"\}$

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-type` erforderlich	`string` (immer: "text/plain; charset=utf-8")
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")