HTTP API 概览
位于 https://api.base64hub.com/v1 的一个小型 Base64 JSON API。无需密钥,无需账号,支持 CORS。本页介绍所有接口的共同点。
基础 URL 和接口
https://api.base64hub.com/v1
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /v1/encode | 文本或原始字节转 Base64 |
POST | /v1/decode | Base64 转文本、十六进制或原始字节 |
POST | /v1/validate | 检查 Base64 并描述它 |
GET | /v1/health | 状态和版本 |
GET | /v1/openapi.json | API 的 OpenAPI 3.1 描述 |
GET https://api.base64hub.com/ 会重定向(302)到本页。请求无需认证。
请求格式
每个接口只接受一组固定的内容类型,其他类型一律返回 415 unsupported_media_type。
| 接口 | Content-Type | 请求体 |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | 原始字节;选项放在查询字符串中 |
| decode、validate | application/json | {"input": "<base64>"} |
| decode、validate | text/plain | Base64 本身 |
请求体必须是 UTF-8(encode 的原始字节除外)。未知的 JSON 字段和未知的查询参数会以 400 invalid_body 拒绝,而不是被忽略,所以拼错的选项绝不会悄无声息地失效。只有配合 application/octet-stream 请求体时,才会读取查询选项。
响应为 JSON(application/json; charset=utf-8),只有带 Accept: application/octet-stream 的 decode 例外,它返回原始字节。
CORS 和响应头
每个响应都带有:
Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff
预检 OPTIONS 请求会得到 204,其中列出允许的方法以及 Content-Type 和 Accept 请求头,所以可以在任何网页中用 fetch() 调用这个 API。
限制
- 请求体大小: 1 MB(1048576 字节)。更大的请求体会得到
413 too_large。 - 速率限制:
/v1/下的路径,每个 IP 地址每 10 秒 20 个请求。该限制由位于 API 前面的 Cloudflare 执行。超出限制时会得到状态码429和 Cloudflare 自己的响应,它不是 JSON,也没有 CORS 头,所以浏览器脚本看到的是网络错误,而不是可读的响应体。 - 换行宽度: 0 到 1000 个字符。
API 不保存任何状态,也不记录请求体。处理大文件或机密信息时,请使用本地工具,例如 b64 CLI。
错误
API 自身返回的错误是 JSON,包含稳定的 code 和人类可读的 message:
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| 状态码 | 代码 | 何时出现 |
|---|---|---|
| 400 | invalid_body | JSON 格式错误、字段类型错误、缺少 input、未知的字段或查询参数、请求体不是 UTF-8 |
| 400 | invalid_base64 | decode 的输入不是 Base64;消息会指出问题及其位置 |
| 404 | not_found | 未知路径 |
| 405 | method_not_allowed | 该路径不支持此方法;Allow 头会列出正确的方法 |
| 413 | too_large | 请求体超过 1 MB |
| 415 | unsupported_media_type | 接口不接受的 Content-Type |
| 429 | 无 | 达到速率限制;响应来自 Cloudflare,不是 JSON |
| 500 | internal_error | API 内部发生意外故障 |
Validate 以状态码 200 报告无效的 Base64,因为“无效”正是它所回答的问题的答案。见 校验。
OpenAPI
机器可读的描述位于 https://api.base64hub.com/v1/openapi.json。把它导入 API 客户端或代码生成器,就能得到每个接口的现成请求。
更新于 2026年11月22日