Decodificação Base64

Sugestões Relacionadas

O que é Decodificação Base64?

Casos de uso

• Decodificar campos Base64 retornados por APIs para visualizar o conteúdo original
• Restaurar dados codificados em Base64 encontrados em arquivos de log
• Recuperar valores codificados em Base64 em arquivos de configuração (.env, .json, .yaml)
• Diagnosticar erros de decodificação Base64 (padding ausente, caracteres ilegais, variante errada)
• Decodificar header e payload de JWT durante o desenvolvimento para inspecionar claims
• Recuperar credenciais Basic Auth decodificando o cabeçalho Authorization
• Decodificar payloads de webhooks para inspecionar callbacks antes de processar

Como Usar

1. Cole a string Base64 que deseja decodificar
2. Selecione o charset (UTF-8, ASCII ou ISO-8859-1)
3. A ferramenta decodifica Base64 automaticamente e exibe o resultado
4. Copie o texto decodificado para usar em depuração ou documentação

Recursos

• Decodificação em tempo real: converte automaticamente enquanto você digita, debounce de 300ms, sem precisar clicar
• Múltiplos charsets suportados: UTF-8, ASCII e ISO-8859-1 cobrindo português, inglês e idiomas multilíngues
• Compatível com URL-Safe Base64: trata - e _ automaticamente, aceita formato sem padding
• Detecção de caracteres ilegais: indica a posição exata do erro na string Base64 ao decodificar
• Copiar e baixar em um clique: copia o resultado decodificado para a área de transferência ou salva como .txt
• Processamento 100% local: nenhum dado é enviado a servidores, preservando privacidade
• Suporte à variantes: Standard e URL-Safe (Base64URL) reconhecidas automaticamente na colagem

Exemplos de Código

// Decodificar Base64 com suporte a UTF-8 (português, emojis)
function b64Decode(str) {
  // Converte string Base64 URL-Safe para Standard
  const normalized = str.replace(/-/g, '+').replace(/_/g, '/');
  // Recompõe padding se necessário
  const padded = normalized + '='.repeat((4 - normalized.length % 4) % 4);
  // Decodifica e converte de Latin-1 para UTF-8
  return decodeURIComponent(escape(atob(padded)));
}

console.log(b64Decode('SGVsbG8gV29ybGQ=')); // Hello World
console.log(b64Decode('T2zDoQ=='));

// Versão URL-Safe nativa (atob suporta direto em navegadores modernos)
function b64UrlDecode(str) {
  return decodeURIComponent(escape(atob(str)));
}

import base64

# Decodificação Standard (UTF-8)
encoded = 'SGVsbG8gV29ybGQ='
decoded = base64.b64decode(encoded).decode('utf-8')
print(decoded)  # Hello World

# Decodificação URL-Safe (com padding opcional)
url_safe = 'SGVsbG8gV29ybGQ'
decoded_url = base64.urlsafe_b64decode(url_safe + '=' * (4 - len(url_safe) % 4)).decode('utf-8')
print(decoded_url)  # Hello World

# Decodificar payload JWT (header.payload.signature)
def decode_jwt_payload(token):
    payload = token.split('.')[1]
    # Adiciona padding se necessário
    payload += '=' * (4 - len(payload) % 4)
    return base64.urlsafe_b64decode(payload).decode('utf-8')

print(decode_jwt_payload('eyJhbGc.eyJzdWIiOiIxMjM.SflKxw'))

import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Base64DecodeExample {
    public static void main(String[] args) {
        String encoded = "SGVsbG8gV29ybGQ=";

        // Decodificação Standard
        String decoded = new String(
            Base64.getDecoder().decode(encoded),
            StandardCharsets.UTF_8
        );
        System.out.println(decoded); // Hello World

        // Decodificação URL-Safe (sem padding)
        String urlSafe = "SGVsbG8gV29ybGQ";
        String decodedUrl = new String(
            Base64.getUrlDecoder().decode(urlSafe),
            StandardCharsets.UTF_8
        );
        System.out.println(decodedUrl);

        // Decodificação MIME (com quebras de linha a cada 76 caracteres)
        String mime = "SGVsbG8gV29ybGQ=";
        String decodedMime = new String(
            Base64.getMimeDecoder().decode(mime),
            StandardCharsets.UTF_8
        );
        System.out.println(decodedMime);
    }
}

Perguntas frequentes

Solução de Problemas

Glossário

Base64

Esquema de codificação binário-para-texto definido na RFC 4648, que representa qualquer sequência de bytes usando 64 caracteres ASCII: A-Z, a-z, 0-9, + e /. É a base da 'decodificação Base64' — processo reverso usado para recuperar dados originais.

Base64URL (URL-Safe Base64)

Variante definida em RFC 4648 §5 que troca + por - e / por _, além de frequentemente omitir o padding (=). Usada em JWT, OAuth PKCE, parâmetros de URL e nomes de arquivo. Precisa ser convertida para Base64 Standard antes da decodificação em ferramentas que não reconhecem a variante automaticamente.Ferramenta Base64URLFerramenta JWT

Padding (=)

Caractere '=' usado para preencher o final de uma string Base64 até que seu comprimento seja múltiplo de 4. Cada '=' representa um byte de padding. A maioria dos decodificadores aceita omitir o '=' ao decodificar, mas algumas implementações exigem o padding completo.

atob / btoa

APIs nativas do navegador para decodificar e codificar Base64 respectivamente. atob ('ASCII to binary') decodifica uma string Base64 retornando uma string binária Latin-1. Para suportar UTF-8 (português, emojis etc.) é necessário combinar atob com decodeURIComponent e escape.Documentação MDN atob()

UTF-8

Codificação de caracteres dominante na web, capaz de representar qualquer caractere Unicode usando 1 a 4 bytes por caractere. É o charset padrão para textos em português com acentuação (á, é, í, ó, ú, ã, õ, ç). Strings Base64 que representam texto em português quase sempre devem ser decodificadas como UTF-8.

ISO-8859-1 (Latin-1)

Codificação legada de 1 byte por caractere que cobre idiomas da Europa Ocidental. É o charset que o atob do navegador opera nativamente. Strings Base64 geradas por sistemas antigos (Java até a versão 8, alguns bancos de dados) podem estar em ISO-8859-1 e exigir essa seleção.Documentação WHATWG ISO-8859-1

ASCII

Codificação de 7 bits (128 caracteres) cobrindo o alfabeto inglês básico, dígitos e símbolos. Útil quando a string Base64 representa apenas comandos, paths ou identificadores sem acentuação. Escolher ASCII em textos com acentos gera perda de informação na decodificação.

InvalidCharacterError

Erro lançado pelo navegador (DOMException) quando a string Base64 contém caracteres fora do alfabeto esperado. Causas comuns: espaços ou quebras de linha não tratados, mistura das variantes Standard/URL-Safe, ou URL-encoded indevidamente. A decodificação só prossegue após remover ou normalizar esses caracteres.

Variantes de Base64 — qual decodificar?

Charsets suportados na decodificação

Authoritative References

• ReferenceRFC 4648 - The Base16, Base32, and Base64 Data Encodings
• ReferenceRFC 7519 - JSON Web Token (JWT)
• ReferenceMDN Web Docs - WindowOrWorkerGlobalScope.atob()
• ReferenceMDN Web Docs - WindowOrWorkerGlobalScope.btoa()
• ReferenceWikipedia - Base64
• ReferenceNode.js - Buffer.from(string, 'base64')
• ReferencePython - base64.b64decode