PDFドキュメントのContent-Type
PDFファイルの配信やアップロード用のContent-Typeヘッダーを設定します。インライン表示とダウンロード、Content-Dispositionオプションを解説します。
File Uploads
詳細な説明
PDF Content-Type
PDFファイルはapplication/pdfメディアタイプを使用します。これはWeb上で最も広く認識されているバイナリContent-Typeの1つです。
ヘッダー値
Content-Type: application/pdf
インライン表示とダウンロード
Content-DispositionでブラウザのPDF処理方法を制御します:
インライン(ブラウザ内で表示):
Content-Type: application/pdf
Content-Disposition: inline; filename="invoice.pdf"
ダウンロード(保存ダイアログを強制):
Content-Type: application/pdf
Content-Disposition: attachment; filename="invoice.pdf"
Charsetは不要
PDFはバイナリフォーマットなので、charsetパラメータは適用されず含めるべきではありません。PDF内のテキストの文字エンコーディングはPDFフォーマット内部で処理されます。
PDFのアップロード
マルチパートフォームの一部としてPDFをアップロードする場合、個別のパートに独自のContent-Typeがあります:
------FormBoundary
Content-Disposition: form-data; name="document"; filename="contract.pdf"
Content-Type: application/pdf
[PDFバイナリデータ]
------FormBoundary--
Content-Length
PDFを配信する際は、クライアントがダウンロードの進捗を表示できるように常にContent-Lengthを含めます:
Content-Type: application/pdf
Content-Length: 2458190
Content-Disposition: attachment; filename="report.pdf"
curlの例
# PDFのアップロード
curl -X POST \
-H "Content-Type: application/pdf" \
--data-binary @document.pdf \
https://api.example.com/documents
ユースケース
ドキュメント管理システム、請求書生成ツール、レポートダウンローダー、PDFファイルを配信または受け付ける機能の構築時に使用します。すべてのブラウザの組み込みPDFビューアで動作します。