上传文件
  1. base64hub
  2. 文档
  3. HTTP API
  4. 解码

POST解码

把 Base64 还原为文本或原始字节。输入可以使用任一字母表,可以省略填充,也可以带 data: 前缀。

POSThttps://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="}'

请求体参数

名称类型说明
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
}
字段类型说明
outputstring 或 null解码后的文本;字节不是 UTF-8 时为 null。
utf8boolean字节是否为有效的 UTF-8。
hexstring以小写十六进制表示的字节。仅在 utf8 为 false 时出现。
bytes_outinteger解码出的字节数。

原始字节

要取回文件,就用 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

错误

无效的 Base64 会以 400 invalid_base64 拒绝。消息会指出第一个问题及其位置,位置在去掉空白后从 0 开始计数:

400 Bad Request · application/json
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
状态码代码原因
400invalid_base64出现两种字母表之外的字符、中间出现 =、超过两个 =,或者长度导致最后一组只剩一个字符。
400invalid_body不是有效的 JSON,缺少 input 或它不是字符串,有未知字段或查询参数,或者请求体不是 UTF-8。
413too_large请求体超过 1 MB。
415unsupported_media_typeContent-Type 不是 application/json 或 text/plain。
429无达到速率限制;见 限制。

想检查字符串而不收到错误状态码,请使用 校验。

更新于 2026年11月22日