Novo Robot /tus/store para uploads retomáveis de arquivos

Joseph Grabski

Líder de conteúdo · Rochester, Reino Unido · Mostrar biografia

Como tem acontecido ultimamente, hoje apresentamos um novo Robot: o Robot /tus/store. /tus/store é um novo Robot de exportação que permite exportar seus arquivos para qualquer servidor compatível com o protocolo tus⁠, permitindo que os uploads dos arquivos para o destino possam ser retomados.

O que é o tus?

tus é um protocolo de upload poderoso e robusto que permite uploads retomáveis de arquivos e lida com interrupções de forma transparente. Isso o torna ideal para quem tem uma conexão com a internet ruim ou instável. O tus conta com amplo suporte em várias plataformas, incluindo a Supabase. O tus permite retomar uploads, mas não oferece segurança inerente à transferência. O HTTPS e a autenticação e a autorização do endpoint determinam a segurança da transferência.

Se você quer se aprofundar nos detalhes técnicos do protocolo e saber como adicionar suporte ao tus no seu servidor, recomendamos consultar o site do tus⁠.

Usar /tus/store

Se você quer começar logo, vamos ver um Template que usa o Robot /tus/store.

O endpoint de demonstração abaixo é descartável e não deve receber arquivos sensíveis. Em produção, substitua endpoint pelo seu próprio endpoint tus configurado, usando HTTPS e a autenticação e a autorização exigidas pelo destino.

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "resize": {
      "use": ":original",
      "robot": "/image/resize",
      "width": "250",
      "height": "250",
      "resize_strategy": "fillcrop",
      "result": true,
      "imagemagick_stack": "v3.0.1"
    },
    "export": {
      "use": [":original", "resize"],
      "robot": "/tus/store",
      "endpoint": "https://tusd.tusdemo.net/files/"
    }
  }
}

No Template acima, primeiro redimensionamos uma imagem e depois a exportamos para o endpoint de demonstração do tus usando o Robot /tus/store.

Felizmente, esse endpoint não exige que credenciais sejam enviadas com a requisição. No entanto, nem sempre é assim. Às vezes, o servidor de destino exige informações adicionais sobre a origem do arquivo. Se o seu endpoint exigir credenciais, você pode incluí-las na requisição usando o parâmetro credentials, que você pode criar da mesma forma que em qualquer outro Robot de exportação.

Primeiro, acesse a página de credenciais de Template e crie um novo conjunto de credenciais de terceiros.

Selecione HTTP/HTTPS como serviço e dê às credenciais um nome fácil de lembrar. Depois, na seção “Cabeçalhos”, você pode adicionar os valores que o destino exige para realizar o upload. A configuração deve ficar semelhante à captura de tela abaixo.

Agora você deve ter tudo o que precisa para começar a usar o Robot /tus/store. Para conhecer em detalhes todos os recursos disponíveis nesse Robot, consulte a documentação.