Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Developer Workspace

    O que é multipart?

    O multipart reúne partes com cabeçalhos próprios em uma mensagem. Em formulários, o multipart/form-data permite enviar texto e arquivos no mesmo corpo.

    Também chamado de: multipart/form-data, mensagem multipart

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    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

    Partes com cabeçalhos próprios

    O multipart é um formato de mensagem que separa o corpo em partes por meio de delimitadores. Cada parte pode conter seus próprios cabeçalhos e seu conteúdo, permitindo reunir materiais de tipos diferentes na mesma mensagem.

    O tipo multipart/form-data usa essa organização para transmitir campos de formulário e arquivos. O cabeçalho Content-Disposition de cada parte identifica o nome do campo. Uma parte com arquivo também pode informar o nome desse arquivo e seu tipo de conteúdo.

    O papel do boundary no formulário

    Em um exemplo didático de atendimento, um formulário envia a descrição do problema e uma imagem. A descrição ocupa a parte descricao e a imagem ocupa anexo, que contém os bytes do arquivo. O servidor recebe as duas partes em uma única requisição e usa os nomes dos campos para associar o texto e a imagem ao atendimento.

    O cabeçalho geral informa o separador por meio do parâmetro boundary, como neste exemplo:

    Content-Type: multipart/form-data; boundary=separador123

    As linhas delimitadoras no corpo usam --separador123 e a última termina com mais dois hífens: --separador123--. O receptor precisa dessa correspondência para localizar as partes. O valor de boundary não pode produzir um delimitador que apareça dentro do conteúdo de uma delas.

    Envio com FormData no navegador

    O FormData representa os campos e os arquivos no código. Ao usá-lo como corpo de uma chamada a fetch no navegador, você deve deixar o navegador gerar o Content-Type com o separador correspondente. Definir manualmente apenas multipart/form-data pode deixar o cabeçalho sem o boundary necessário.

    Um formulário recusado ou recebido sem campos exige conferir o cabeçalho e os delimitadores do corpo, além dos nomes esperados pelo servidor. Mesmo com o corpo interpretado corretamente, o servidor ainda precisa validar o tamanho e o conteúdo dos arquivos.

    Dúvidas frequentes

    Perguntas frequentes sobre multipart

    Multipart envia cada parte em uma requisição?
    As partes podem seguir juntas no corpo de uma única requisição. Essa divisão descreve o formato da mensagem e não obriga a abrir uma conexão ou realizar uma requisição por campo.
    O parâmetro boundary identifica o arquivo?
    Ele informa o separador entre as partes. No multipart/form-data, o parâmetro name do cabeçalho Content-Disposition identifica o campo. O parâmetro filename pode informar o nome do arquivo.
    Devo definir o Content-Type ao enviar FormData com fetch?
    No navegador, deixe o próprio fetch definir esse cabeçalho ao receber um FormData como corpo. Assim, o boundary informado corresponde ao separador que o navegador escreve na mensagem.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    O envio de campos e arquivos exige conferir o formato do corpo aceito pela integração.

    Conhecer a formação
    Capa da Formação Developer Workspace

    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