Digite para filtrar os verbetes do Glossário.

    Automação e integrações · n8n Experts

    O que é base64?

    A Base64 converte bytes em caracteres para transportar arquivos em campos de texto. A codificação é reversível, aumenta o tamanho e não cifra o conteúdo.

    Também chamado de: Base 64, codificação Base64

    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

    Como os bytes viram caracteres

    A Base64 é uma codificação que transforma uma sequência de bytes em caracteres de texto. Ela permite incluir um arquivo binário em um campo textual, como uma string de uma mensagem JSON.

    O codificador reúne três bytes em um bloco de 24 bits e o divide em quatro grupos de seis bits. Cada grupo seleciona um caractere de um alfabeto com 64 símbolos. Quando o último grupo de entrada tem menos de três bytes, a forma padrão usa o sinal = para completar a saída. A RFC 4648 define esse mecanismo.

    Uma conversão que você pode conferir no Node.js

    O exemplo abaixo usa o texto Oi para deixar a entrada e a saída visíveis. O mesmo processo de codificação aceita os bytes de um arquivo.

    const bytes = Buffer.from('Oi', 'utf8');
    const codificado = bytes.toString('base64');
    const recuperado = Buffer.from(codificado, 'base64');
    console.log(codificado);
    console.log(recuperado.toString('utf8'));

    A saída contém T2k= na primeira linha e Oi na segunda. Os dois bytes da entrada geram quatro caracteres, incluindo o preenchimento. A decodificação recupera os bytes originais, como documenta a referência de Buffer do Node.js.

    Para uma imagem, você usaria os bytes recuperados como conteúdo do arquivo. A conversão final para UTF-8 só faz sentido neste exemplo porque a entrada é texto nessa codificação.

    Tamanho e compatibilidade na integração

    A Base64 aumenta o tamanho da representação e permite recuperar o conteúdo sem uma chave secreta. Portanto, um token ou arquivo privado codificado dessa forma continua exigindo proteção contra leitura indevida.

    Você também precisa conferir a variante exigida pela API. A Base64url altera dois símbolos do alfabeto e pode omitir o preenchimento quando o protocolo permite. O uso de um decodificador permissivo não comprova que a mensagem enviada cumpre o formato exigido pelo destino.

    Dúvidas frequentes

    Perguntas frequentes sobre base64

    A Base64 mantém uma senha em segredo?
    A sequência pode ser decodificada sem uma chave secreta. Uma senha em Base64 continua legível após a conversão, por isso exige os cuidados de transporte e armazenamento próprios de uma credencial.
    Quanto a Base64 aumenta o tamanho?
    Cada três bytes completos geram quatro caracteres. Com o preenchimento padrão, o comprimento é quatro vezes o número de grupos de três bytes, arredondado para cima. Em arquivos grandes, o aumento se aproxima de 33%, sem incluir outros campos da mensagem.
    Base64 e Base64url usam os mesmos caracteres?
    A Base64url substitui o sinal de mais e a barra pelos caracteres hífen e sublinhado. O protocolo que a utiliza também define se o preenchimento com o sinal de igual pode ser omitido.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    n8n Experts

    Uma integração que recebe arquivos em Base64 precisa identificar o campo codificado e recuperar os bytes no formato esperado pela API de destino.

    Conhecer a formação
    Capa da formação n8n Experts

    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