- base64hub
- Docs
Documentação do base64hub
Referência de tudo o que o base64hub oferece fora do site. Todos os produtos seguem as mesmas regras de Base64, então o que você aprende numa página vale para as outras.
Escolha um produto
| Você quer | Use | Documentação |
|---|---|---|
| Codificar ou decodificar num terminal ou script | a CLI b64 | CLI |
| Chamar funções Base64 no Node.js | o base64hub do npm | Pacote npm |
| Chamar funções Base64 no Python | o base64hub do PyPI | Pacote Python |
| Dar a um assistente de IA ferramentas Base64 exatas | base64hub-mcp | Servidor MCP |
| Codificar ou decodificar no Chrome sem abrir uma aba | a extensão | Extensão do Chrome |
| Fazer requisições HTTP de qualquer linguagem ou ferramenta no-code | https://api.base64hub.com/v1 | API HTTP |
| Codificar ou decodificar pelo celular | @base64hubbot | Bot do Telegram |
Todos são gratuitos, têm licença MIT e nenhum tem dependências em tempo de execução. Os comandos de instalação e os downloads estão na página de downloads.
Regras comuns
Os produtos compartilham uma especificação e um conjunto de vetores de teste, então batem byte a byte.
A codificação usa o alfabeto padrão da RFC 4648 com preenchimento =, a menos que você peça o alfabeto URL-safe (- e _) ou nenhum preenchimento. A quebra insere um \n a cada N caracteres, nunca no final; 76 é o tamanho de linha do MIME. Data URIs nunca são quebradas, e o tipo MIME delas é detectado pelo conteúdo quando você não informa um: PNG, JPEG, GIF, WebP, PDF e SVG pelas assinaturas, depois text/plain;charset=utf-8 para texto UTF-8, e application/octet-stream nos outros casos.
A decodificação é tolerante de propósito:
- Os espaços em branco das pontas são removidos, assim como um prefixo
data:...;base64,. - Espaços, tabulações, CR e LF no meio do texto são ignorados.
- O preenchimento
=no final é opcional. Mais de dois=, ou um=em qualquer outro lugar, é erro. - Os dois alfabetos são aceitos, até misturados na mesma string.
- Qualquer outro caractere é erro, assim como um tamanho que deixa um único caractere no último grupo de quatro.
- Uma entrada vazia decodifica para uma saída vazia.
Os erros são informados da esquerda para a direita, com as posições contadas a partir de 0 na entrada já limpa. A CLI e a API os escrevem assim:
invalid character '!' at position 4
unexpected '=' at position 2: padding is only allowed at the end
too much padding: 3 '=' at position 2, at most 2 are allowed
invalid length: 5 characters leave a single character in the last group
A validação dá certo exatamente quando a decodificação daria. Ela também informa a variant (standard se aparece + ou /, url se aparece - ou _, mixed se aparecem os dois, either se nenhum), se a entrada está padded até um múltiplo de quatro, e o tamanho decodificado em bytes.
Onde só é possível mostrar texto, como no JSON da API, nos resultados do MCP e no bot, os bytes decodificados que não são UTF-8 válido aparecem em hex, em vez de caracteres embaralhados.
O próprio site
As ferramentas do base64hub.com rodam no seu navegador e nunca chamam a API: uma Content Security Policy bloqueia todas as requisições, exceto a contagem anônima de visualizações de página. Os exemplos de código desta documentação são para copiar; nada nestas páginas envia requisições para a API.
Atualizado 22 de nov. de 2026