PDFをBase64に変換してAPIに送る方法
電子請求書、電子署名、配送などのAPIでは、書類をJSONの項目に入れて送るよう求められます。PDFを正しい形式のテキストに変換し、確認して、リクエストが失敗する原因を避ける方法を説明します
執筆: Metin Ersoy · 更新日: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に変換を開く