Endpoints
| Método | Caminho | O que faz |
|---|---|---|
POST | /v1/encode | texto ou bytes puros para Base64; padrão ou URL-safe, preenchimento, quebra de linha |
POST | /v1/decode | Base64 para texto, hex no caso de binário, ou os bytes puros |
POST | /v1/validate | se é Base64, qual alfabeto, se tem preenchimento, quantos bytes |
GET | /v1/health | status e versão |
GET | /v1/openapi.json | a descrição OpenAPI 3.1 |
Requisições e respostas são JSON. O encode também aceita bytes puros como application/octet-stream, e o decode pode devolver bytes puros quando você os pede com Accept: application/octet-stream.
Uma requisição e a resposta dela
Codificar uma string como Base64 URL-safe sem preenchimento:
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
O decode funciona do mesmo jeito e avisa quando os bytes não são texto:
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
O decodificador é tolerante de propósito: espaços e quebras de linha, um prefixo data:...;base64,, preenchimento ausente e qualquer um dos dois alfabetos são aceitos. Os erros de verdade voltam como 400 invalid_base64, com o caractere inválido e a posição dele, por exemplo invalid character '!' at position 4.
Limites e comportamento
- Autenticação: nenhuma, sem chave nem token.
- Limite de requisições: 20 a cada 10 segundos por endereço IP. Acima do limite, você recebe status 429 da Cloudflare.
- Tamanho do corpo: até 1 MB. Corpos maiores recebem
413 too_large. - Entradas rígidas: campos JSON e parâmetros de query desconhecidos são rejeitados com
400 invalid_body, então um erro de digitação no nome de uma opção nunca passa despercebido. - CORS:
Access-Control-Allow-Origin: *em toda resposta, preflight respondido. - Cache: toda resposta vem com
Cache-Control: no-store.
A visão geral da API tem a tabela completa de erros e as regras de cada tipo de conteúdo.
Quando usar uma API para Base64
Calcular Base64 custa pouco, e toda linguagem já tem isso embutido: btoa nos navegadores, Buffer no Node.js, o módulo base64 no Python. Chamar um serviço web para isso faz sentido quando:
- você está numa ferramenta no-code, numa planilha ou num construtor de webhooks que faz requisições HTTP, mas não executa código;
- você quer a mesma decodificação tolerante e a mesma validação em todas as linguagens, sem precisar portá-las;
- você está testando ou ensinando e quer uma resposta de referência para comparar.
Para qualquer coisa sensível, como tokens ou chaves privadas, prefira uma ferramenta local: as ferramentas no navegador deste site, a CLI ou os pacotes npm e Python dão resultados idênticos sem que os dados saiam da sua máquina.
Perguntas frequentes
A API do base64hub é grátis mesmo?
Sim. Não há chave nem conta. Um limite de 20 requisições a cada 10 segundos por endereço IP mantém a API disponível para todos.
A API guarda o que eu envio?
Não. Ela roda como um Cloudflare Worker sem armazenamento e não registra o corpo das requisições. Mesmo assim, não mande segredos para nenhum serviço web quando uma ferramenta local resolve; a CLI b64 dá os mesmos resultados offline.
Dá para chamar a API Base64 com JavaScript no navegador?
Sim. Toda resposta traz Access-Control-Allow-Origin: * e as requisições de preflight são respondidas, então o fetch() funciona a partir de qualquer origem.
Qual o tamanho máximo de arquivo que a API codifica?
O corpo da requisição é limitado a 1 MB. Para arquivos maiores, use a CLI, que trabalha em fluxo, ou a ferramenta Arquivo para Base64 no seu navegador.