PDF Base64 変換ツール

JSON API で PDF を送信する

JSON にはバイナリ型がないため、文書を受け取る REST API では通常、Base64 文字列として受け渡します。電子署名プラットフォーム、請求書・電子請求システム、印刷・郵送サービス、OCR エンジン、文書アーカイブなどでは、content、file、documentBase64 といったフィールドで PDF を受け付け、ファイル名は別のフィールドで指定するのが一般的です。同じ方法で PDF を返すサービスもあり、Base64 を PDF に変換を使えばファイルに戻せます。

API ドキュメントに特に指定がない限り、改行なしの Base64 文字列を送信してください。data:application/pdf;base64, プレフィックスが付いたままの値は、多くの API で拒否されます。リクエストサイズの上限にも注意が必要です。7.5 MB の PDF は約 10 MB の Base64 になります。

Base64 化された PDF の見分け方

PDF ファイルは %PDF- という文字とそれに続くバージョン番号で始まります。このバイト列を Base64 にエンコードすると、必ず JVBERi0 で始まる文字列になります。API のレスポンス、データベースのカラム、ログファイルに JVBER で始まる長い文字列があれば、ほぼ確実に PDF です。ペイロードを送信する前にも同じ確認ができます。文字列がほかの文字で始まっている場合は、別のデータをエンコードしたか、二重にエンコードした可能性があります。

HTML に PDF を埋め込む

data URI を使うと、PDF 全体を HTML ページの中に配置でき、別途ファイルをホストする必要がありません。

<embed src="data:application/pdf;base64,JVBERi0..." type="application/pdf" width="100%" height="600">

<iframe src="data:application/pdf;base64,JVBERi0..." width="100%" height="600"></iframe>

この方法は PDF ビューアーを内蔵したデスクトップブラウザでは動作しますが、制限もあります。多くのモバイルブラウザは、ページ内に PDF をまったく表示できません。また、Chrome などのブラウザでは、ページがタブ全体を data: URL に移動させることがブロックされるため、data:application/pdf URI を指すリンクや window.open の呼び出しでは、空白のタブが開くか、何も起こらないことがあります。JavaScript から新しいタブで PDF を開くには、代わりに Base64 を Blob URL に変換してください。数 MB を超える文書では、通常のファイル URL を使うほうが一般的に適しています。

コードで PDF をエンコードする

# Python：JSON リクエストボディを作成
import base64, json
from pathlib import Path

pdf_b64 = base64.b64encode(Path('invoice.pdf').read_bytes()).decode('ascii')
body = json.dumps({'filename': 'invoice.pdf', 'content': pdf_b64})

// ブラウザ：file は <input type="file"> から取得
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // data URI のプレフィックスを除去
};
reader.readAsDataURL(file);