POST校验
使用字符串之前,先检查它是不是 Base64。答案包括字母表、填充和解码后的大小,或者它无效的原因。
POST
https://api.base64hub.com/v1/validate请求
输入与 解码 相同:带 input 的 JSON,或者以 text/plain 请求体发送的 Base64。
curl -s https://api.base64hub.com/v1/validate \
-H 'Content-Type: text/plain' \
-d '-_-_'
const res = await fetch("https://api.base64hub.com/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "-_-_" }),
});
const v = await res.json();
console.log(v.valid, v.variant, v.bytes); // true url 3
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/validate",
data=json.dumps({"input": "-_-_"}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
v = json.load(res)
print(v["valid"], v["variant"], v["bytes"]) # True url 3
b64 --validate -- -_-_
# valid (url, 3 bytes)
请求体参数
| 名称 | 类型 | 说明 |
|---|---|---|
input 必填 | string | 要检查的文本。 |
响应
对于格式正确的请求,Validate 总是返回 200。有效输入:
200 OK · application/json
{
"valid": true,
"variant": "url",
"padded": true,
"bytes": 3
}
无效输入,这里是 Zm9vY:
200 OK · application/json
{
"valid": false,
"error": {
"code": "invalid_base64",
"message": "invalid length: 5 characters leave a single character in the last group"
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
valid | boolean | 恰好在 解码 能成功时为 true。 |
variant | string | 出现 + 或 / 为 standard,出现 - 或 _ 为 url,两者都有为 mixed,都没有为 either。 |
padded | boolean | 清理后的输入(含 =)长度是否为 4 的倍数。 |
bytes | integer | 解码后数据的大小。 |
error | object | 仅在 valid 为 false 时出现:code 为 invalid_base64,message 描述问题及其位置。 |
either 很常见:SGVsbG8sIGh1YiE= 不含这四个特殊字符中的任何一个,所以在两种字母表中都有效。padded: false 不会使输入无效;SGVsbG8sIGh1YiE 是有效的,padded: false,11 个字节。
错误
非 200 状态码的错误针对的是请求本身,而不是 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日