O que é tus?
tus é um protocolo HTTP aberto para uploads retomáveis de arquivos. Um cliente cria ou descobre um recurso de upload, envia bytes a partir de deslocamentos conhecidos e continua a partir do deslocamento confirmado após uma interrupção.
Como o tus funciona
O protocolo tus representa um upload em andamento como um recurso HTTP com uma posição em bytes confirmada pelo servidor. Um cliente acrescenta dados somente nessa posição e pode consultar o recurso após se reconectar, evitando a retransmissão de bytes aceitos. Seu comportamento central é enxuto, enquanto extensões negociadas acrescentam criação, somas de verificação, expiração, concatenação ou definição posterior do comprimento. Em um fluxo de trabalho de ingestão, o tus separa o estado confiável da transferência das etapas posteriores de validação, transcodificação e publicação.
Informações essenciais
- Um cliente envia uma requisição PATCH com
Upload-Offset, e o servidor a aceita somente quando esse valor corresponde ao estado armazenado; um conflito de deslocamento impede que bytes sejam acrescentados silenciosamente no lugar errado. - HEAD recupera o deslocamento atual do servidor para que um cliente interrompido possa retomar, enquanto o cabeçalho
Tus-Resumableidentifica a versão do protocolo esperada para requisições e respostas compatíveis. - As extensões opcionais de soma de verificação e expiração tratam de modos de falha diferentes: uma detecta blocos corrompidos, enquanto a outra informa aos clientes que um recurso de upload inacabado pode deixar de existir.
Quando o tus é relevante
Escolha o tus para uploads grandes ou conexões instáveis em que reiniciar uma transferência inteira seria custoso. As implementações de cliente e servidor devem concordar sobre os deslocamentos e as extensões, ou a retomada pode falhar.