接口
| 方法 | 路径 | 作用 |
|---|---|---|
POST | /v1/encode | 文本或原始字节转 Base64;标准或 URL 安全,可选填充和换行 |
POST | /v1/decode | Base64 转文本,二进制数据转十六进制,或返回原始字节 |
POST | /v1/validate | 是不是 Base64、哪种字母表、是否填充、有多少字节 |
GET | /v1/health | 状态和版本 |
GET | /v1/openapi.json | OpenAPI 3.1 描述 |
请求和响应都是 JSON。encode 也接受以 application/octet-stream 发送的原始字节;用 Accept: application/octet-stream 请求时,decode 可以返回原始字节。
请求和响应示例
把一个字符串编码为不带填充的 URL 安全 Base64:
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}
decode 的用法相同,字节不是文本时会告诉你:
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
解码器有意设计得宽松:空格和换行、data:...;base64, 前缀、缺失的填充以及两种字母表都接受。真正的错误会以 400 invalid_base64 返回,并给出有问题的字符及其位置,例如 invalid character '!' at position 4。
限制与行为
- 认证: 无,不需要密钥或令牌。
- 速率限制: 每个 IP 地址每 10 秒 20 个请求。超出限制时,Cloudflare 会返回状态码 429。
- 请求体大小: 最大 1 MB。更大的请求体会得到
413 too_large。 - 严格的输入: 未知的 JSON 字段和查询参数会以
400 invalid_body拒绝,所以选项名拼错绝不会被悄悄忽略。 - CORS: 每个响应都带有
Access-Control-Allow-Origin: *,预检请求会得到响应。 - 缓存: 每个响应都是
Cache-Control: no-store。
API 概览 提供完整的错误表,以及每种内容类型的规则。
什么时候用 API 处理 Base64
Base64 的计算成本很低,每种语言都内置了它:浏览器中有 btoa,Node.js 中有 Buffer,Python 中有 base64 模块。在以下情况下,调用 Web 服务来做这件事才说得通:
- 你在使用无代码工具、电子表格或 webhook 构建器,它们能发 HTTP 请求,却不能运行代码;
- 你希望在每种语言中都获得同样宽松的解码和校验,而不必逐一移植;
- 你在测试或教学,需要一个可以对照的参考答案。
处理任何敏感内容,例如令牌或私钥时,请优先使用本地工具:本站的 浏览器工具、CLI,或者 npm 和 Python 软件包都能给出完全相同的结果,数据也不会离开你的电脑。
常见问题
base64hub API 真的免费吗?
是的。不需要密钥,也不需要账号。每个 IP 地址每 10 秒 20 个请求的速率限制,保证了每个人都能用上。
API 会存储我发送的内容吗?
不会。它作为不带存储的 Cloudflare Worker 运行,也不记录请求体。即便如此,能用本地工具解决的事,就不要把机密发给任何 Web 服务;b64 CLI 离线也能得到相同的结果。
可以在浏览器中用 JavaScript 调用这个 Base64 API 吗?
可以。每个响应都带有 Access-Control-Allow-Origin: *,预检请求也会得到响应,所以 fetch() 可以从任何来源调用它。
用这个 API 最大能编码多大的文件?
请求体限制为 1 MB。更大的文件请用支持流式处理的 CLI,或者在浏览器中使用 文件转 Base64 工具。