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

HTTP API 概览

位于 https://api.base64hub.com/v1 的一个小型 Base64 JSON API。无需密钥,无需账号,支持 CORS。本页介绍所有接口的共同点。

基础 URL 和接口

https://api.base64hub.com/v1
方法路径用途
POST/v1/encode文本或原始字节转 Base64
POST/v1/decodeBase64 转文本、十六进制或原始字节
POST/v1/validate检查 Base64 并描述它
GET/v1/health状态和版本
GET/v1/openapi.jsonAPI 的 OpenAPI 3.1 描述

GET https://api.base64hub.com/ 会重定向(302)到本页。请求无需认证。

请求格式

每个接口只接受一组固定的内容类型,其他类型一律返回 415 unsupported_media_type。

接口Content-Type请求体
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-stream原始字节;选项放在查询字符串中
decode、validateapplication/json{"input": "<base64>"}
decode、validatetext/plainBase64 本身

请求体必须是 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"}}
状态码代码何时出现
400invalid_bodyJSON 格式错误、字段类型错误、缺少 input、未知的字段或查询参数、请求体不是 UTF-8
400invalid_base64decode 的输入不是 Base64;消息会指出问题及其位置
404not_found未知路径
405method_not_allowed该路径不支持此方法;Allow 头会列出正确的方法
413too_large请求体超过 1 MB
415unsupported_media_type接口不接受的 Content-Type
429无达到速率限制;响应来自 Cloudflare,不是 JSON
500internal_errorAPI 内部发生意外故障

Validate 以状态码 200 报告无效的 Base64,因为“无效”正是它所回答的问题的答案。见 校验。

OpenAPI

机器可读的描述位于 https://api.base64hub.com/v1/openapi.json。把它导入 API 客户端或代码生成器,就能得到每个接口的现成请求。

更新于 2026年11月22日