POST解码
把 Base64 还原为文本或原始字节。输入可以使用任一字母表,可以省略填充,也可以带 data: 前缀。
POST
https://api.base64hub.com/v1/decode请求
把 Base64 放在 JSON 的 input 中发送,或者以 Content-Type: text/plain 把它作为整个请求体发送。
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: application/json' \
-d '{"input": "SGVsbG8sIGh1YiE="}'
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "SGVsbG8sIGh1YiE=" }),
});
const data = await res.json();
console.log(data.output); // Hello, hub!
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=json.dumps({"input": "SGVsbG8sIGh1YiE="}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # Hello, hub!
b64 -d SGVsbG8sIGh1YiE=
# Hello, hub!
请求体参数
| 名称 | 类型 | 说明 |
|---|---|---|
input 必填 | string | 要解码的 Base64。 |
使用 Content-Type: text/plain 时,整个请求体就是输入,外面没有 JSON。此接口不接受查询参数。
解码器接受:
- 任意位置的空格、制表符和换行,例如按 MIME 换行的 Base64;
data:<type>;base64,前缀,它会被去掉;- 缺失的
=填充; - 标准字母表和 URL 安全字母表,即使混用也可以。
响应
200 OK · application/json
{
"output": "Hello, hub!",
"utf8": true,
"bytes_out": 11
}
解码出的字节不是有效的 UTF-8 时,output 为 null,字节以十六进制给出。下面是 +/+/ 的响应:
200 OK · application/json
{
"output": null,
"utf8": false,
"hex": "fbffbf",
"bytes_out": 3
}
| 字段 | 类型 | 说明 |
|---|---|---|
output | string 或 null | 解码后的文本;字节不是 UTF-8 时为 null。 |
utf8 | boolean | 字节是否为有效的 UTF-8。 |
hex | string | 以小写十六进制表示的字节。仅在 utf8 为 false 时出现。 |
bytes_out | integer | 解码出的字节数。 |
原始字节
要取回文件,就用 Accept: application/octet-stream 请求字节。这时响应体就是解码后的数据,外面没有 JSON。
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' \
-H 'Accept: application/octet-stream' \
--data-binary @photo.b64 -o photo.jpg
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "text/plain", Accept: "application/octet-stream" },
body: "SGk=",
});
const bytes = new Uint8Array(await res.arrayBuffer());
console.log(bytes); // Uint8Array(2) [ 72, 105 ]
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=b"SGk=",
headers={"Content-Type": "text/plain", "Accept": "application/octet-stream"},
)
with urllib.request.urlopen(req) as res:
print(res.read()) # b'Hi'
b64 -d -i photo.b64 -o photo.jpg
错误
无效的 Base64 会以 400 invalid_base64 拒绝。消息会指出第一个问题及其位置,位置在去掉空白后从 0 开始计数:
400 Bad Request · application/json
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| 状态码 | 代码 | 原因 |
|---|---|---|
| 400 | invalid_base64 | 出现两种字母表之外的字符、中间出现 =、超过两个 =,或者长度导致最后一组只剩一个字符。 |
| 400 | invalid_body | 不是有效的 JSON,缺少 input 或它不是字符串,有未知字段或查询参数,或者请求体不是 UTF-8。 |
| 413 | too_large | 请求体超过 1 MB。 |
| 415 | unsupported_media_type | Content-Type 不是 application/json 或 text/plain。 |
| 429 | 无 | 达到速率限制;见 限制。 |
想检查字符串而不收到错误状态码,请使用 校验。
更新于 2026年11月22日