- base64hub
- ドキュメント
base64hub ドキュメント
base64hub が Web サイトの外で提供しているものすべてのリファレンスです。どの製品も同じ Base64 のルールに従っているので、あるページで学んだことは他のページでもそのまま通用します。
製品を選ぶ
| やりたいこと | 使うもの | ドキュメント |
|---|---|---|
| ターミナルやスクリプトでエンコード・デコードする | b64 CLI | CLI |
| Node.js から Base64 の関数を呼ぶ | npm の base64hub | npm パッケージ |
| Python から Base64 の関数を呼ぶ | PyPI の base64hub | Python パッケージ |
| AI アシスタントに正確な Base64 ツールを与える | base64hub-mcp | MCP サーバー |
| タブを開かずに Chrome でエンコード・デコードする | 拡張機能 | Chrome 拡張機能 |
| どの言語やノーコードツールからでも HTTP リクエストで使う | https://api.base64hub.com/v1 | HTTP API |
| スマートフォンでエンコード・デコードする | @base64hubbot | Telegram ボット |
どれも無料で MIT ライセンスで、実行時の依存関係はありません。インストールコマンドとダウンロードは ダウンロードページ にあります。
共通のルール
すべての製品が 1 つの仕様書と 1 組のテストベクターを共有しているので、結果はバイト単位で一致します。
エンコード では、URLセーフなアルファベット(- と _)やパディングなしを指定しない限り、RFC 4648 の標準アルファベットと = パディングを使います。折り返しでは N 文字ごとに \n を入れ、末尾には入れません。76 が MIME の行の長さです。data URI は折り返さず、MIME タイプを指定しなければ内容から判定します。PNG、JPEG、GIF、WebP、PDF、SVG はシグネチャで判定し、次に UTF-8 テキストなら text/plain;charset=utf-8、それ以外は application/octet-stream です。
デコード は意図的に寛容です。
- 前後の空白を取り除き、
data:...;base64,接頭辞も取り除きます。 - テキスト中の空白、タブ、CR、LF は無視します。
- 末尾の
=パディングは省略できます。=が 3 つ以上ある場合や、末尾以外に=がある場合はエラーです。 - 両方のアルファベットを受け付けます。1 つの文字列の中で混在していてもかまいません。
- それ以外の文字はエラーです。最後の 4 文字のグループに 1 文字だけ残る長さもエラーになります。
- 空の入力は空の出力になります。
エラーは左から右へ見つけた順に報告し、位置は空白などを取り除いた後の入力で 0 から数えます。CLI と API のメッセージは次のとおりです。
invalid character '!' at position 4
unexpected '=' at position 2: padding is only allowed at the end
too much padding: 3 '=' at position 2, at most 2 are allowed
invalid length: 5 characters leave a single character in the last group
検証 は、デコードが成功する場合にだけ成功します。さらに、variant(+ か / があれば standard、- か _ があれば url、両方あれば mixed、どちらもなければ either)、入力が 4 の倍数に padded されているかどうか、デコード後のサイズ bytes も報告します。
API の JSON、MCP の結果、ボットのようにテキストしか表示できない場面では、有効な UTF-8 でないデコード結果を、文字化けさせずに 16 進数で返します。
Web サイトについて
base64hub.com のツールはブラウザ内で動き、API を呼び出すことはありません。Content Security Policy が、匿名のページビュー計測以外のリクエストをすべてブロックしています。このドキュメントのコード例はコピーして使うためのもので、これらのページから API にリクエストが送られることはありません。
更新日 2026/11/22