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ビューアで動作します。

試してみる — Content-Type Header Builder

フルツールを開く