エンドポイント
| メソッド | パス | 機能 |
|---|---|---|
POST | /v1/encode | テキストや生のバイト列を Base64 に。標準または URLセーフ、パディング、折り返し |
POST | /v1/decode | Base64 をテキストに。バイナリなら 16 進数、または生のバイト列 |
POST | /v1/validate | Base64 かどうか、どのアルファベットか、パディングの有無、何バイトか |
GET | /v1/health | ステータスとバージョン |
GET | /v1/openapi.json | OpenAPI 3.1 の記述 |
リクエストとレスポンスは JSON です。encode は application/octet-stream で生のバイト列も受け付け、decode は Accept: application/octet-stream を指定すると生のバイト列を返します。
リクエストとレスポンスの例
文字列をパディングなしの URLセーフな Base64 にエンコードします。
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
decode も同じ要領で使えます。バイト列がテキストでないときは、そのことを教えてくれます。
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
デコーダーは意図的に寛容で、空白や改行、data:...;base64, 接頭辞、パディングの欠落、どちらのアルファベットも受け付けます。本当のエラーは 400 invalid_base64 として、問題の文字とその位置付きで返ります。たとえば invalid character '!' at position 4 です。
制限と動作
- 認証: なし。キーもトークンも不要です。
- レート制限: IP アドレスごとに 10 秒あたり 20 リクエスト。超えると Cloudflare からステータス 429 が返ります。
- ボディのサイズ: 1 MB まで。それより大きいボディには
413 too_largeが返ります。 - 厳格な入力: 未知の JSON フィールドやクエリパラメーターは
400 invalid_bodyで拒否されるので、オプション名のタイプミスを見逃すことはありません。 - CORS: すべてのレスポンスに
Access-Control-Allow-Origin: *が付き、プリフライトにも応答します。 - キャッシュ: すべてのレスポンスが
Cache-Control: no-storeです。
エラーの一覧と、コンテンツタイプごとのルールは API の概要 にあります。
Base64 に API を使うべき場面
Base64 の計算は軽く、どの言語にも組み込まれています。ブラウザなら btoa、Node.js なら Buffer、Python なら base64 モジュールです。Web サービスを呼び出す意味があるのは、次のような場合です。
- ノーコードツール、スプレッドシート、Webhook ビルダーなど、HTTP リクエストは送れてもコードは実行できない環境にいる。
- 移植の手間をかけずに、どの言語でも同じ寛容なデコードと検証を使いたい。
- テストや教育の場面で、比較の基準になる答えが欲しい。
トークンや秘密鍵のような機密性の高いものには、ローカルのツールを使ってください。このサイトの ブラウザ版ツール、CLI、npm や Python のパッケージなら、データがマシンの外に出ることなく同じ結果が得られます。
よくある質問
base64hub の API は本当に無料ですか?
はい。キーもアカウントもありません。IP アドレスごとに 10 秒あたり 20 リクエストというレート制限を設けて、誰でも使える状態を保っています。
API は送った内容を保存しますか?
保存しません。ストレージを持たない Cloudflare Worker として動き、リクエストボディをログに残すこともありません。それでも、ローカルのツールで済むなら、どんな Web サービスにもシークレットは送らないでください。b64 CLI ならオフラインで同じ結果が得られます。
ブラウザの JavaScript から Base64 API を呼べますか?
呼べます。すべてのレスポンスに Access-Control-Allow-Origin: * が付き、プリフライトリクエストにも応答するので、どのオリジンからでも fetch() が使えます。
API でエンコードできるファイルの大きさは?
リクエストボディは 1 MB までです。それより大きなファイルには、ストリーム処理する CLI か、ブラウザで動く ファイルを Base64 に変換 を使ってください。