Descargar una subida tus

Descarga los bytes de una subida reanudable, incluidas las respuestas por rangos compatibles.

GET{UPLOAD_URL}

Nota

Usa la URL de capacidad de carga del encabezado Location de la respuesta exitosa de creación de carga. No utiliza las credenciales implícitas del host de API2.

Este endpoint descarga los bytes recibidos hasta el momento, incluso si la carga aún no ha finalizado. Una respuesta HTTP 200 o 206 satisfactoria no significa que la carga esté completa. Una carga sin bytes recibidos puede devolver HTTP 200 con un cuerpo vacío. En una respuesta de rango, el tamaño indicado en Content-Range es el tamaño almacenado actual, no la longitud final declarada de la carga.

Antes de descargar una carga completa, consulta su desplazamiento. Comprueba que Upload-Length esté presente y que Upload-Offset sea igual a Upload-Length. Upload-Defer-Length: 1 significa que la longitud total aún se desconoce, por lo que la transferencia no está completa.

El procesamiento de la Assembly y el éxito de la exportación son independientes de la finalización de esta transferencia tus. Comprueba el Assembly Status final y sus resultados antes de publicar un recurso procesado.

Ejemplo de solicitud

Establece UPLOAD_URL en la URL Location completa que se devuelve al crear la carga tus. Mantén esta URL en secreto.

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

Headers de la solicitud

JSON Schema completo

Abrir JSON en una pestaña nueva

Encabezados normalizados en minúsculas para la extensión de descarga de tusd.

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`if-match`	`string` (longitud mínima: 1, longitud máxima: 8192) Una etiqueta de entidad o comodín con el que debe coincidir la subida.
`if-modified-since`	`string` (longitud mínima: 1, longitud máxima: 8192) Una fecha HTTP tras la cual se devuelve una subida que haya sido modificada.
`if-none-match`	`string` (longitud mínima: 1, longitud máxima: 8192) Una etiqueta de entidad o comodín con el que no debe coincidir la subida.
`if-range`	`string` (longitud mínima: 1, longitud máxima: 8192) Una etiqueta de entidad o fecha HTTP que condiciona un rango de bytes.
`if-unmodified-since`	`string` (longitud mínima: 1, longitud máxima: 8192) Una fecha HTTP tras la cual una subida modificada incumple la condición previa.
`range`	`string` (longitud máxima: 8192) Uno o varios rangos de bytes canónicos. Patrón de validación (expresión regular) `^bytes=(?:[0-9]+-[0-9]\|-[0-9]+)(?:,(?:[0-9]+-[0-9]\|-[0-9]+))*$`
`tus-resumable`	`string` (siempre: "1.0.0") La versión de tus negociada cuando el cliente la proporciona.

Respuesta

HTTP 200

Cuerpo binario de la respuesta. */*

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`accept-ranges` obligatorio	`string` (siempre: "bytes")
`content-disposition` obligatorio	`string` (longitud mínima: 1)
`content-length` obligatorio	`string` Un recuento de bytes canónico, sin signo y en base 10, dentro del rango de 64 bits con signo, sin relleno de ceros ni signo más. Patrón de validación (expresión regular) `^(?: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` obligatorio	`string` Patrón de validación (expresión regular) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obligatorio	`string` (longitud mínima: 1)
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")

HTTP 206

Cuerpo binario de la respuesta. */*

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Campo	Tipo y descripción
`accept-ranges` obligatorio	`string` (siempre: "bytes")
`content-disposition` obligatorio	`string` (longitud mínima: 1)
`content-length` obligatorio	`string` Un recuento de bytes canónico, sin signo y en base 10, dentro del rango de 64 bits con signo, sin relleno de ceros ni signo más. Patrón de validación (expresión regular) `^(?: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` obligatorio	`string` (longitud mínima: 1)
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: content-range, content-type

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-range` obligatorio	`string` El intervalo de bytes devuelto, con ambos extremos incluidos, y el tamaño almacenado actualmente, no la longitud final declarada de la carga. Patrón de validación (expresión regular) `^bytes [0-9]+-[0-9]+\/[0-9]+$`
`content-type` obligatorio	`string` Patrón de validación (expresión regular) `^[a-z]+\/[a-z0-9+.-]+$`

propiedades obligatorias: content-type

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-range`	`nunca` Este valor está prohibido.
`content-type` obligatorio	`string` Patrón de validación (expresión regular) `^multipart\/byteranges; boundary=[0-9a-f]{60}$`

HTTP 304

Sin cuerpo de respuesta.

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-disposition` obligatorio	`string` (longitud mínima: 1)
`last-modified` obligatorio	`string` (longitud mínima: 1)
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")

HTTP 412

Sin cuerpo de respuesta.

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-disposition` obligatorio	`string` (longitud mínima: 1)
`content-type` obligatorio	`string` Patrón de validación (expresión regular) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obligatorio	`string` (longitud mínima: 1)
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")

HTTP 416

Cuerpo de respuesta de texto. text/plain; charset=utf-8

Esquema del cuerpo de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

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

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Campo	Tipo y descripción
`content-disposition` obligatorio	`string` (longitud mínima: 1)
`content-type` obligatorio	`string` (siempre: "text/plain; charset=utf-8")
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: content-range

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-range` obligatorio	`string` El tamaño almacenado actual para un rango de bytes no satisfecho, no la longitud final declarada de la carga. Patrón de validación (expresión regular) `^bytes [*]\/[0-9]+$`

Variante 2

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-range`	`nunca` Este valor está prohibido.

Respuesta de error

Cuerpo de respuesta de texto. text/plain; charset=utf-8

Esquema del cuerpo de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

string

Puede aplicarse cualquiera de los esquemas siguientes:

Variante 1: string

string

Patrón de validación (expresión regular)

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

Variante 2: string

string

Formato de error text/plain sin procesar de un hook con un payload literal; tiene aspecto de JSON, pero no es necesariamente JSON válido.

Patrón de validación (expresión regular)

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

Headers de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

Campo	Tipo y descripción
`content-type` obligatorio	`string` (siempre: "text/plain; charset=utf-8")
`tus-resumable` obligatorio	`string` (siempre: "1.0.0")
`x-content-type-options` obligatorio	`string` (siempre: "nosniff")