Digite para filtrar os verbetes do Glossário.

    Automação e integrações · Vibe Coding: Do Zero ao MVP

    O que é envio retomável?

    O envio retomável continua um upload a partir da posição aceita pelo servidor. No tus, o cliente consulta essa posição para transmitir o restante do arquivo.

    Também chamado de: resumable upload, upload retomável

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    O que permite retomar o envio

    O envio retomável é uma forma de transferir um arquivo em etapas que podem continuar após uma interrupção. O servidor conserva a parte aceita e informa ao cliente de onde prosseguir. Isso evita retransmitir o arquivo inteiro quando a conexão cai.

    O tus é um protocolo para esse tipo de upload. Nele, o cliente consulta o endereço do envio com uma requisição HEAD e recebe a posição em bytes no cabeçalho Upload-Offset. A requisição PATCH seguinte leva o restante a partir dessa posição, mesmo que o contador local indique uma quantidade maior já transmitida.

    Como interpretar a posição em bytes

    Num exemplo didático, um arquivo tem 100 bytes e a consulta retorna Upload-Offset: 70. Esse valor indica que os primeiros 70 bytes foram aceitos. O cliente envia os 30 restantes num PATCH com a mesma posição inicial. Uma resposta bem-sucedida informa o novo valor, 100, que coincide com o tamanho do arquivo.

    Se o cliente tentar continuar da posição 80 quando o servidor estiver na 70, o tus exige a resposta 409 Conflict sem alterar o recurso. Você precisa consultar novamente a posição, pois repetir a tentativa com o mesmo número mantém a divergência.

    Até quando a retomada funciona

    A retomada exige que o upload parcial ainda exista. Um serviço com a extensão de expiração pode removê-lo após o prazo indicado em Upload-Expires. A conclusão do transporte também é diferente da aceitação do arquivo pela aplicação, que pode precisar verificar seu formato e seu conteúdo.

    Dúvidas frequentes

    Perguntas frequentes sobre envio retomável

    Como o cliente descobre de onde retomar no tus?
    Uma requisição HEAD ao endereço do upload retorna a posição atual no cabeçalho Upload-Offset. O contador local de bytes enviados não confirma quanto o servidor aceitou.
    O que acontece quando as posições não coincidem?
    O servidor responde com 409 Conflict e mantém o recurso sem alteração. O cliente precisa consultar a posição atual para preparar uma nova tentativa.
    Um upload parcial pode expirar?
    Sim. A extensão de expiração do tus informa o prazo em Upload-Expires. Se o servidor já removeu o recurso, o cliente precisa iniciar outro upload.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao desenvolver um upload, você precisa conferir a retomada após uma queda de conexão e o tratamento do arquivo recebido.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano