Baixar um upload tus

Baixa bytes de um upload retomável, incluindo respostas de intervalo (range) suportadas.

GET{UPLOAD_URL}

Observação

Use a URL de capacidade de upload do cabeçalho Location da resposta bem-sucedida de criação de upload. Ela não usa credenciais implicitamente disponíveis associadas ao host da API2.

Este endpoint baixa os bytes recebidos até o momento, mesmo enquanto um upload ainda não foi concluído. Uma resposta HTTP 200 ou 206 bem-sucedida não significa que o upload está completo. Um upload sem nenhum byte recebido pode retornar HTTP 200 com corpo vazio. Em uma resposta de intervalo, o tamanho em Content-Range é o tamanho armazenado atual, não o tamanho final declarado do upload.

Antes de baixar um upload completo, consulte o offset dele. Verifique se Upload-Length está presente e se Upload-Offset é igual a Upload-Length. Upload-Defer-Length: 1 significa que o tamanho total ainda é desconhecido, portanto a transferência não está completa.

O processamento da Assembly e o sucesso da exportação são independentes da conclusão desta transferência tus. Verifique o Assembly Status final e os resultados dele antes de publicar um ativo processado.

Exemplo de requisição

Defina UPLOAD_URL como a URL Location completa retornada ao criar o upload tus. Mantenha essa URL em segredo.

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

Cabeçalhos da requisição

Esquema JSON completo

Abrir JSON em uma nova aba

Cabeçalhos normalizados em minúsculas para a extensão de download do tusd.

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`if-match`	`string` (comprimento mínimo: 1, comprimento máximo: 8192) Uma tag de entidade ou curinga com o qual o upload deve corresponder.
`if-modified-since`	`string` (comprimento mínimo: 1, comprimento máximo: 8192) Uma data HTTP após a qual um upload modificado é retornado.
`if-none-match`	`string` (comprimento mínimo: 1, comprimento máximo: 8192) Uma tag de entidade ou curinga ao qual o upload não deve corresponder.
`if-range`	`string` (comprimento mínimo: 1, comprimento máximo: 8192) Uma tag de entidade ou data HTTP que torna um intervalo de bytes condicional.
`if-unmodified-since`	`string` (comprimento mínimo: 1, comprimento máximo: 8192) Uma data HTTP após a qual um upload modificado falha na pré-condição.
`range`	`string` (comprimento máximo: 8192) Um ou mais intervalos de bytes canônicos. Padrão de validação (expressão regular) `^bytes=(?:[0-9]+-[0-9]\|-[0-9]+)(?:,(?:[0-9]+-[0-9]\|-[0-9]+))*$`
`tus-resumable`	`string` (sempre: "1.0.0") A versão do tus negociada, quando o cliente a fornece.

Resposta

HTTP 200

Corpo binário da resposta. */*

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`accept-ranges` obrigatório	`string` (sempre: "bytes")
`content-disposition` obrigatório	`string` (comprimento mínimo: 1)
`content-length` obrigatório	`string` Uma contagem de bytes canônica, sem sinal e em base 10, dentro do intervalo de 64 bits com sinal, sem zeros à esquerda nem sinal de mais. Padrão de validação (expressão 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` obrigatório	`string` Padrão de validação (expressão regular) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obrigatório	`string` (comprimento mínimo: 1)
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")

HTTP 206

Corpo binário da resposta. */*

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campo	Tipo e descrição
`accept-ranges` obrigatório	`string` (sempre: "bytes")
`content-disposition` obrigatório	`string` (comprimento mínimo: 1)
`content-length` obrigatório	`string` Uma contagem de bytes canônica, sem sinal e em base 10, dentro do intervalo de 64 bits com sinal, sem zeros à esquerda nem sinal de mais. Padrão de validação (expressão 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` obrigatório	`string` (comprimento mínimo: 1)
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: content-range, content-type

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-range` obrigatório	`string` O intervalo de bytes retornado (inclusivo) e o tamanho atualmente armazenado, não o comprimento final declarado do upload. Padrão de validação (expressão regular) `^bytes [0-9]+-[0-9]+\/[0-9]+$`
`content-type` obrigatório	`string` Padrão de validação (expressão regular) `^[a-z]+\/[a-z0-9+.-]+$`

propriedades obrigatórias: content-type

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-range`	`nunca` Este valor é proibido.
`content-type` obrigatório	`string` Padrão de validação (expressão regular) `^multipart\/byteranges; boundary=[0-9a-f]{60}$`

HTTP 304

Sem corpo de resposta.

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-disposition` obrigatório	`string` (comprimento mínimo: 1)
`last-modified` obrigatório	`string` (comprimento mínimo: 1)
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")

HTTP 412

Sem corpo de resposta.

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-disposition` obrigatório	`string` (comprimento mínimo: 1)
`content-type` obrigatório	`string` Padrão de validação (expressão regular) `^[a-z]+\/[a-z0-9+.-]+$`
`last-modified` obrigatório	`string` (comprimento mínimo: 1)
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")

HTTP 416

Corpo da resposta em texto. text/plain; charset=utf-8

Esquema do corpo da resposta

Esquema JSON completo

Abrir JSON em uma nova aba

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

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campo	Tipo e descrição
`content-disposition` obrigatório	`string` (comprimento mínimo: 1)
`content-type` obrigatório	`string` (sempre: "text/plain; charset=utf-8")
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: content-range

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-range` obrigatório	`string` O tamanho atualmente armazenado para um intervalo de bytes não satisfeito, não o comprimento final declarado do upload. Padrão de validação (expressão regular) `^bytes [*]\/[0-9]+$`

Variante 2

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-range`	`nunca` Este valor é proibido.

Resposta de erro

Corpo da resposta em texto. text/plain; charset=utf-8

Esquema do corpo da resposta

Esquema JSON completo

Abrir JSON em uma nova aba

string

Qualquer um dos esquemas a seguir pode ser aplicado:

Variante 1: string

string

Padrão de validação (expressão regular)

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

Variante 2: string

string

Enquadramento bruto de erro de hook em text/plain com um payload literal; tem formato de JSON, mas não é necessariamente um JSON válido.

Padrão de validação (expressão 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])*"\}$

Cabeçalhos de resposta

Esquema JSON completo

Abrir JSON em uma nova aba

Campos além dos listados para este objeto são aceitos.

Campo	Tipo e descrição
`content-type` obrigatório	`string` (sempre: "text/plain; charset=utf-8")
`tus-resumable` obrigatório	`string` (sempre: "1.0.0")
`x-content-type-options` obrigatório	`string` (sempre: "nosniff")