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=separador123As 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
Documentação
RFC 7578: multipart/form-data
Define o multipart/form-data e detalha a identificação dos campos e o uso do separador entre as partes.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.