Transloadit

Obter o offset de um upload tus

Retorna o offset de bytes atual e os metadados de um upload retomável.

HEAD{UPLOAD_URL}

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

Cabeçalhos da requisição

Esquema JSON completo

Abrir JSON em uma nova aba

Cabeçalhos normalizados em minúsculas para uma requisição HEAD tus canônica.

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

CampoTipo e descrição
tus-resumable

obrigatório

string (sempre: "1.0.0")

A versão negociada do tus.

Resposta

HTTP 200

Sem corpo de resposta.

Cabeçalhos de resposta
Esquema JSON completo

Abrir JSON em uma nova aba

CampoTipo e descrição
cache-control

obrigatório

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

obrigatório

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

Ou partial ou final; seguido de uma ou mais URLs de capacidade de upload separadas por espaço, retornadas pela criação parcial bem-sucedida. O ponto e vírgula após final é obrigatório.

Qualquer um dos esquemas a seguir pode ser aplicado:

string (sempre: "partial")
string
Variante 2: string
string
Padrão de validação (expressão regular)^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

Chaves de metadados separadas por vírgula e valores em Base64 padrão canônico serializados pelo runtime fixado do tus.

Padrão de validação (expressão regular)^(?:\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

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)$
x-content-type-options

obrigatório

string (sempre: "nosniff")

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: content-length, upload-length

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

CampoTipo e descrição
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)$
upload-defer-length
nunca

Este valor é proibido.

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

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

CampoTipo e descrição
content-length
nunca

Este valor é proibido.

upload-defer-length

obrigatório

string (sempre: "1")
upload-length
nunca

Este valor é proibido.

Resposta de erro

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.

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