HTTP API の概要
https://api.base64hub.com/v1 にある、Base64 用の小さな JSON API です。キーもアカウントも不要で、CORS に対応しています。このページでは、すべてのエンドポイントに共通する内容を説明します。
ベース URL とエンドポイント
https://api.base64hub.com/v1
| メソッド | パス | 用途 |
|---|---|---|
POST | /v1/encode | テキストや生のバイト列を Base64 に |
POST | /v1/decode | Base64 をテキスト、16 進数、生のバイト列に |
POST | /v1/validate | Base64 をチェックし、その内容を報告 |
GET | /v1/health | ステータスとバージョン |
GET | /v1/openapi.json | API の OpenAPI 3.1 記述 |
GET https://api.base64hub.com/ はこのページにリダイレクト(302)します。リクエストに認証は要りません。
リクエストの形式
各エンドポイントは決まったコンテンツタイプだけを受け付け、それ以外には 415 unsupported_media_type を返します。
| エンドポイント | Content-Type | ボディ |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | 生のバイト列。オプションはクエリ文字列で指定 |
| decode、validate | application/json | {"input": "<base64>"} |
| decode、validate | text/plain | Base64 そのもの |
ボディは 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"}}
| ステータス | コード | 発生する場面 |
|---|---|---|
| 400 | invalid_body | 不正な JSON、フィールドの型の誤り、input の欠落、未知のフィールドやクエリパラメーター、UTF-8 でないボディ |
| 400 | invalid_base64 | decode の入力が Base64 でない。メッセージに問題とその位置が示される |
| 404 | not_found | 不明なパス |
| 405 | method_not_allowed | パスに対してメソッドが違う。正しいメソッドは Allow ヘッダーに示される |
| 413 | too_large | ボディが 1 MB を超えている |
| 415 | unsupported_media_type | エンドポイントが受け付けない Content-Type |
| 429 | なし | レート制限に達した。レスポンスは Cloudflare から返り、JSON ではない |
| 500 | internal_error | API 内部の予期しない障害 |
validate は無効な Base64 をステータス 200 で報告します。「有効ではない」ことが、尋ねられた質問への答えだからです。詳しくは 検証 をご覧ください。
OpenAPI
機械可読の記述は https://api.base64hub.com/v1/openapi.json にあります。API クライアントやコードジェネレーターに読み込めば、すべてのエンドポイントのリクエストがすぐに使える形で手に入ります。
更新日 2026/11/22