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étodo | Caminho | Para que serve |
|---|---|---|
POST | /v1/encode | texto ou bytes puros para Base64 |
POST | /v1/decode | Base64 para texto, hex ou bytes puros |
POST | /v1/validate | confere o Base64 e o descreve |
GET | /v1/health | status e versão |
GET | /v1/openapi.json | descriçã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.
| Endpoint | Content-Type | Corpo |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | bytes puros; opções na query string |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/plain | o 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 status429com 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"}}
| Status | Código | Quando |
|---|---|---|
| 400 | invalid_body | JSON malformado, tipos de campo errados, input ausente, campos ou parâmetros de query desconhecidos, um corpo que não é UTF-8 |
| 400 | invalid_base64 | a entrada do decode não é Base64; a mensagem indica o problema e a posição dele |
| 404 | not_found | caminho desconhecido |
| 405 | method_not_allowed | método errado para o caminho; o header Allow lista os corretos |
| 413 | too_large | corpo acima de 1 MB |
| 415 | unsupported_media_type | um Content-Type que o endpoint não aceita |
| 429 | nenhum | limite de requisições atingido; a resposta vem da Cloudflare, não em JSON |
| 500 | internal_error | uma 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