PDFVela — pdfvela.com
すべてのPDFツール

PDFをBase64に変換してAPIに送る方法

電子請求書、電子署名、配送などのAPIでは、書類をJSONの項目に入れて送るよう求められます。PDFを正しい形式のテキストに変換し、確認して、リクエストが失敗する原因を避ける方法を説明します

執筆: · 更新日:2026年11月10日

APIが通常求めている形

多くの書類系APIでは、JSON本文にcontent、file、data、documentといった名前の項目があります。その値がPDFのBase64コードで、ファイル名や種類と一緒に送ることがよくあります。

{
  "fileName": "invoice-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

コードを書き始める前に、ドキュメントで3つの点を確認しましょう。項目名、data:接頭辞が必要かどうか(たいていは不要)、そしてサイズの上限です。

1. PDFをBase64に変換する

テスト用の値をいちばん手早く用意するには、PDFをBase64に変換を使います。PDFを選び、「Base64コードのみ」を選んで結果をコピーします。たたき台になるリクエスト本文を丸ごと用意したいなら、代わりに「ファイル名・種類・内容を含むJSON」を選んでください。ファイル名と種類が自動で入ります。PDFはブラウザ内でエンコードされ、アップロードされません。テストに使う書類が本物の請求書なら、これは大事なポイントです。

結果を確認しましょう。JVBERi0で始まり、スペースを含まず、末尾の1〜2個の=を除けば英字、数字、+、/だけでできているはずです。

2. コードから送信する

よく使われる3つの言語で、同じ処理を書いた例です。どれもファイルを読み込み、エンコードして、JSONをPOSTします。

# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "invoice.pdf", "content": content})

macOSでは、curlの行で-w 0の代わりにbase64 -i invoice.pdfを使います。アドレスと項目名は例です。お使いのサービスのドキュメントに書かれているものに置き換えてください。

3. 往復で確認する

サービスが書類や保存したコピーをBase64で返してくる場合は、その応答をBase64をPDFに変換に貼り付けます。1ページ目とページ数が表示されれば、途中で何も失われていないことをいちばん早く確かめられます。逆方向の詳しい手順は、Base64文字列をPDFファイルとして保存する方法で説明しています。

よくある失敗

症状考えられる原因対処法
「Invalid Base64」改行(76文字ごと)またはdata:接頭辞が入っている接頭辞のないコードを1行で送る
「Payload too large」(413)エンコード後のPDFが大きすぎるPDF圧縮で小さくする
PDFが白紙で開く、または壊れている文字列が途中で切れているもう一度エンコードし、値全体を送る
日本語などのファイル名が文字化けするファイル名が誤った文字コードで送られているJSON本文をUTF-8で統一する

さっそく試してみませんか?無料で、ファイルはお使いのデバイスから外に出ません。

PDFをBase64に変換を開く

PDFをBase64で送るときのよくある質問

APIがファイルではなくBase64を求めるのはなぜですか?

JSONはテキストしか扱えないからです。Base64はPDFのバイト列を英字、数字、+、/で書き表すので、顧客番号や請求日などのほかのデータと並べて、書類全体を1つの文字列の項目に収められます。

data:application/pdf;base64,の接頭辞も送るべきですか?

たいていは不要です。ほとんどのAPIは、JVBERi0で始まるコードだけを想定しています。データURIを送るのは、ドキュメントにそう書かれている場合か、iframeなどでブラウザがURLを必要とする場合だけにしましょう。

APIから「Base64が無効」と返されます。いちばん多い原因は?

文字列に改行や接頭辞が入っているか、貼り付けたときにコードが途中で切れていることです。接頭辞のないコードを1行で使い、文字列が最後まで欠けずに届いているか確認してください。

PDFはどのくらいの大きさまで送れますか?

サービスによって異なりますが、テキストにするとファイルより約3分の1大きくなるため、3 MBのPDFはおよそ4 MBのJSONになります。多くのAPIは数MBが上限です。いちばん簡単な対策は、先にPDFを圧縮することです。

Base64は暗号化の一種ですか?

いいえ。コードを持っている人なら誰でも書類に戻せます。送るときは必ずHTTPSを使い、機密のPDFを、ファイルをアップロードするWebサイトに貼り付けないでください。