ファイルを選択
  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 をテキスト、16 進数、生のバイト列に
POST/v1/validateBase64 をチェックし、その内容を報告
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 リクエストには、許可するメソッドと、Content-Type と Accept のリクエストヘッダーを示して 204 を返します。そのため、どの Web ページからでも fetch() で API を呼び出せます。

制限

  • ボディのサイズ: 1 MB(1048576 バイト)。それより大きいボディには 413 too_large が返ります。
  • レート制限: /v1/ 以下のパスで、IP アドレスごとに 10 秒あたり 20 リクエスト。制限は API の前段にある Cloudflare が適用します。超えるとステータス 429 が Cloudflare 独自のレスポンスで返ります。これは JSON ではなく CORS ヘッダーも付かないので、ブラウザのスクリプトからは読めるボディではなくネットワークエラーに見えます。
  • 折り返し(wrap): 0 から 1000 文字まで。

API は状態を持たず、リクエストボディをログに残しません。大きなファイルやシークレットには、b64 CLI のようなローカルのツールを使ってください。

エラー

API 自体のエラーは、変わることのない code と、人が読むための message を持つ JSON です。

{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
ステータスコード発生する場面
400invalid_body不正な JSON、フィールドの型の誤り、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 は無効な Base64 をステータス 200 で報告します。「有効ではない」ことが、尋ねられた質問への答えだからです。詳しくは 検証 をご覧ください。

OpenAPI

機械可読の記述は https://api.base64hub.com/v1/openapi.json にあります。API クライアントやコードジェネレーターに読み込めば、すべてのエンドポイントのリクエストがすぐに使える形で手に入ります。

更新日 2026/11/22