---
title: Form
slug: aura/form
docTags: 
createdAt: 2025-07-07T20:39:55.890Z
---

Biblioteca utilizada para converter bytes em um array de bytes formatado como multipart/form-data, que
é o padrão para envio de arquivos e dados em requisições HTTP.

## Atalhos

- **[Encode](docId\:ZNRe7o0QnJbWjblnNBIoZ)**

***

### Métodos

### Encode

```lua
-- @param fields é uma table contendo os campos do formulário. Nessa table pode ser entregue strigs e tabelas.
--               As strings são tratadas como campos de texto e as tabelas devem conter um campo "bytes".
--               Opcionalmente, pode-se incluir "filename" e "mime" para arquivos.
-- @return Uma table contendo "body"  e "content_type" (o cabeçalho Content-Type).
encode(fields)
```

```lua
-- example usage:

local form_data = form.encode({
    language = "pt", 
    audio_file = {
        bytes = "conteúdo do arquivo em bytes",
        filename = "meuarquivo.mp3",
        mime = "audio/mpeg"
    }
})

print(form_data.body)         -- Conteúdo codificado do formulário para ser enviado como BODY
print(form_data.content_type) -- Content-Type para ser configurado no HEADERS
```