Enviar um arquivo
  1. base64hub
  2. Docs
  3. API HTTP

Visão geral da API HTTP

Uma pequena API JSON para Base64 em https://api.base64hub.com/v1. Sem chave, sem conta, com CORS ativado. Esta página cobre o que todos os endpoints têm em comum.

URL base e endpoints

https://api.base64hub.com/v1
MétodoCaminhoPara que serve
POST/v1/encodetexto ou bytes puros para Base64
POST/v1/decodeBase64 para texto, hex ou bytes puros
POST/v1/validateconfere o Base64 e o descreve
GET/v1/healthstatus e versão
GET/v1/openapi.jsondescrição OpenAPI 3.1 da API

GET https://api.base64hub.com/ redireciona (302) para esta página. As requisições não precisam de autenticação.

Formatos de requisição

Cada endpoint aceita um conjunto fixo de tipos de conteúdo e responde a qualquer outro com 415 unsupported_media_type.

EndpointContent-TypeCorpo
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-streambytes puros; opções na query string
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plaino próprio Base64

Os corpos precisam estar em UTF-8 (exceto os bytes puros enviados ao encode). Campos JSON e parâmetros de query desconhecidos são rejeitados com 400 invalid_body em vez de ignorados, então uma opção digitada errado nunca falha em silêncio. As opções da query string só são lidas junto com um corpo application/octet-stream.

As respostas são JSON (application/json; charset=utf-8), exceto o decode com Accept: application/octet-stream, que devolve os bytes puros.

CORS e headers

Toda resposta traz:

Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff

As requisições de preflight OPTIONS recebem 204 com os métodos permitidos e os headers de requisição Content-Type e Accept, então a API pode ser chamada com fetch() de qualquer página web.

Limites

  • Tamanho do corpo: 1 MB (1048576 bytes). Corpos maiores recebem 413 too_large.
  • Limite de requisições: 20 requisições a cada 10 segundos por endereço IP nos caminhos sob /v1/. O limite é aplicado pela Cloudflare, na frente da API. Acima dele, você recebe status 429 com a resposta da própria Cloudflare, que não é JSON e não tem header CORS, então um script no navegador vê um erro de rede em vez de um corpo legível.
  • Wrap: de 0 a 1000 caracteres.

A API não guarda estado e não registra o corpo das requisições. Para arquivos grandes ou segredos, use uma ferramenta local como a CLI b64.

Erros

Os erros da própria API são JSON, com um code estável e uma message legível:

{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
StatusCódigoQuando
400invalid_bodyJSON malformado, tipos de campo errados, input ausente, campos ou parâmetros de query desconhecidos, um corpo que não é UTF-8
400invalid_base64a entrada do decode não é Base64; a mensagem indica o problema e a posição dele
404not_foundcaminho desconhecido
405method_not_allowedmétodo errado para o caminho; o header Allow lista os corretos
413too_largecorpo acima de 1 MB
415unsupported_media_typeum Content-Type que o endpoint não aceita
429nenhumlimite de requisições atingido; a resposta vem da Cloudflare, não em JSON
500internal_erroruma falha inesperada na API

O endpoint validate informa Base64 inválido com status 200, porque “não é válido” é a resposta à pergunta que foi feita. Veja Validar.

OpenAPI

A descrição legível por máquina fica em https://api.base64hub.com/v1/openapi.json. Importe-a num cliente de API ou num gerador de código para ter requisições prontas para todos os endpoints.

Atualizado 22 de nov. de 2026