Base64文字列をPDFファイルとして保存する方法
APIのレスポンスや請求書のXML、メールのソースにJVBERi0で始まる長い文字列があり、その中の書類を取り出したい。コードの探し方からファイルを開くまでを順番に説明します
執筆: Metin Ersoy · 更新日:2026年11月10日
Base64のPDFとは?なぜテキストで届くの?
Base64は、英字、数字、いくつかの記号だけを使ってファイルを書き表す方式です。そのため、JSON、XML、メールのようにテキストしか扱えない形式でも、中にPDFを入れて運べます。コードには書類がそっくりそのまま入っていて、デコードすれば元のファイルが1バイトも違わずに戻ります。デジタル署名もそのまま有効です。
よく出くわすのは、次のような場面です。
- 請求書・会計システムのAPI:電子請求書のプラットフォームや会計ソフトは、請求書のPDF版をBase64のフィールドで返すことがよくあります。UBLのような構造化された請求書XMLにも、印刷用のPDFが同じ方法で埋め込まれていることがあります。
- 配送:出荷を登録すると、配送業者は送り状をBase64のPDFで返すのが一般的です。
- 決済・銀行:領収書、給与明細、取引明細のサービスが、書類をテキストのフィールドで返すことがあります。
- 電子署名・文書管理サービス:署名済みの書類が、署名サービスからBase64で返ってきます。
- メールのソース:メールの生データでは、PDFの添付ファイルはBase64のブロックとして保存されています。
1. コードを探して、全体をコピーする
- JSONのレスポンス:PDFが入っているフィールドを探します。名前はpdf、content、data、document、file、labelなどが多く、値はJVBERi0で始まります。引用符の間にある文字列をすべてコピーしてください。レスポンス全体をコピーしてもかまいません。ツールがJVBERi0で始まる部分を自動で見つけます。
- XMLファイル:PDFが入っている要素(例:EmbeddedDocumentBinaryObject)を探し、開始タグと終了タグの間の文字列をコピーします。途中に改行があっても問題ありません。
- メールのソース:Gmailなら「メッセージのソースを表示」、ほかのメールソフトなら「ソースを表示」などのメニューで生データを開きます。Content-Type: application/pdfとContent-Transfer-Encoding: base64の行の下にあるブロックがPDFの添付ファイルです。次の空行までをすべてコピーします。
- デベロッパーツール:ブラウザの「ネットワーク」タブでレスポンスを開き、フィールドを右クリックして「値をコピー」を選びます。長い文字列を手で選択するより、はるかに確実です。
コードはとても長いので、末尾が欠けやすくなっています。貼り付けたあと、末尾が元のデータと同じになっているか確認してください。
2. コードを変換して書類を確認する
Base64をPDFに変換を開き、「またはテキストを入力・貼り付け」を押してコードを貼り付けます。デコードされるとすぐに1ページ目が表示され、その下にページ数、PDFのバージョン、ファイルサイズが出ます。コードが.txtファイルに保存されている場合は、そのファイルを選ぶだけです。
プレビューで、次の点をすばやく確認できます。
- 目的の書類か:1ページ目で、請求書番号、取引先名、送り状の内容が見えます。
- ページ数は想定どおりか:ページが足りないときは、コードが途中までしかコピーされていません。
- パスワードで保護されていないか:保護されている場合はプレビューの代わりにメッセージが表示されますが、ファイルはそのままの状態で保存されます。
3. PDFを保存して開く
「PDFをダウンロード」を押します。ファイルは変更されずに保存され、どのPDFリーダーでも開けます。あとは用途に合わせて、PDF結合で1か月分の請求書を1つのファイルにまとめたり、PDF圧縮でメールで送れるサイズにしたり、PDFをJPGに変換で1ページ目を画像にしたりできます。
コードの先頭でわかること
| コードの先頭 | 中身のファイル |
|---|---|
| JVBERi0 | PDF書類 |
| data:application/pdf;base64, | PDF書類(data URI) |
| iVBORw0KGgo | PNG画像 |
| /9j/ | JPG写真 |
| UEsDB | ZIP、Word(.docx)、Excel(.xlsx) |
| PD94bWwg | XMLテキスト(例:請求書のデータそのもの) |
最後の行は、電子請求書でよくある勘違いの原因です。サービスによっては、PDFではなく請求書のXMLをBase64で送ってきます。このコードをデコードしても、出てくるのは書類ではなく読めるXMLテキストです。
よくある失敗
コードを拡張子.pdfのテキストファイルとして保存する:ファイルの中身はBase64のテキストのままなので、リーダーは「ファイルが壊れている」と表示します。コードはデコードする必要があります。
値以外の部分までコピーする:コードの末尾に余分な「,」や「status」が入ると、コードが無効になります。値だけをコピーするか、レスポンス全体をコピーしてください。どちらの場合も、ツールがコードを正しく取り出します。
エスケープされた改行:JSONの文字列では、コードが76文字ごとに\nで区切られていることがあります。この文字はPDFの一部ではなく、ツールが自動で取り除きます。
別のレスポンスを見ている:書類がまだできていないと、空のフィールドやエラーメッセージを返すAPIがあります。コードが数百文字程度と極端に短い場合は、PDFではなくエラーメッセージの可能性が高いです。
プライバシーについて
Base64は書類を守るものではなく、形式を変えるだけです。請求書、契約書、診断書、身分証のコピーは、ファイルをサーバーにアップロードするサイトでデコードしないようにしましょう。PDFVelaのツールはお使いのデバイス上でコードをデコードし、ページを読み込んだあとならオフラインになっても動作します。
さっそく試してみませんか?無料で、ファイルはお使いのデバイスから外に出ません。
Base64をPDFに変換を開く