上传文件
  1. base64hub
  2. 文档
  3. HTTP API
  4. 校验

POST校验

使用字符串之前,先检查它是不是 Base64。答案包括字母表、填充和解码后的大小,或者它无效的原因。

POSThttps://api.base64hub.com/v1/validate

请求

输入与 解码 相同:带 input 的 JSON,或者以 text/plain 请求体发送的 Base64。

curl -s https://api.base64hub.com/v1/validate \
  -H 'Content-Type: text/plain' \
  -d '-_-_'

请求体参数

名称类型说明
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"
  }
}
字段类型说明
validboolean恰好在 解码 能成功时为 true。
variantstring出现 + 或 / 为 standard,出现 - 或 _ 为 url,两者都有为 mixed,都没有为 either。
paddedboolean清理后的输入(含 =)长度是否为 4 的倍数。
bytesinteger解码后数据的大小。
errorobject仅在 valid 为 false 时出现:code 为 invalid_base64,message 描述问题及其位置。

either 很常见:SGVsbG8sIGh1YiE= 不含这四个特殊字符中的任何一个,所以在两种字母表中都有效。padded: false 不会使输入无效;SGVsbG8sIGh1YiE 是有效的,padded: false,11 个字节。

错误

非 200 状态码的错误针对的是请求本身,而不是 Base64:

状态码代码原因
400invalid_body不是有效的 JSON,缺少 input 或它不是字符串,有未知字段或查询参数,或者请求体不是 UTF-8。
413too_large请求体超过 1 MB。
415unsupported_media_typeContent-Type 不是 application/json 或 text/plain。
429无达到速率限制;见 限制。

更新于 2026年11月22日