線形化 PDF
PDF4me 線形化 PDF は REST 再構築するエンドポイント PDF 高速なウェブ閲覧のために。 POST ファイルとして Base64 に /api/v2/LinearizePdf と共に optimizeProfile、そして API 内部オブジェクトの順序を変更して、残りのページがまだダウンロード中の間に最初のページをレンダリングし、線形化されたものを返します。 PDF 生のバイトデータとして表示されます。ウェブ、印刷、圧縮の3つのプロファイルが用意されています。
取る PDF そして、同じドキュメントをプログレッシブ読み込み用に再編成して返します。ディレクトリ情報とページ1のリソースがファイルの先頭に移動するため、ブラウザまたは埋め込みビューアは、ダウンロード全体が完了するのを待つことなく、最初のページをほぼ即座に表示します。 pages それ自体は変更されていません。ドキュメントポータル、CDN、およびあらゆる用途に最適です。 PDF 提供 HTTP。
認証 API リクエスト
毎 PDF4me REST 電話にはあなたの API キー Authorization ヘッダーを基本認証として設定します。開発者ダッシュボードからキーを取得またはローテーションしてください。
終点
/api/v2/LinearizePdf見逃してはならない重要な事実
非同期、 JSON ブール値。大文字小文字が間違っているキーは無視され、大きなファイルは同期的に処理されます。HTTP 設定
方法： POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
コンテンツタイプ: アプリケーション/json
Authorization: 基本 <あなたの PDF4me API キー>
200の応答ボディは線形化されています PDF 生のバイトとして: 直接保存します。202 応答は非同期処理を意味します: ポーリングします Location URL と GET 約10秒ごと（公式サンプルでは10秒間隔で最大10回再試行）に200まで実行します。
どのoptimizeProfileを選択すればよいですか？
9件のプロフィールが採用されました。これらはそれぞれ異なる目標を持つ3つのグループに分類されます。
| プロフィール 家族 vs 目標 | プロフィール | 彼らが最適化するもの |
|---|---|---|
| ウェブ | web、 WebMax | ブラウザでのプログレッシブディスプレイと高速なファーストページレンダリング。WebMaxは最も積極的なWeb最適化ツールです。 |
| 印刷 | Print、 PrintMax、 PrintGray | 印刷向け出力。PrintGrayはグレースケール印刷への変換も行う。 |
| 圧縮 | Compress、 CompressMax | ファイルサイズが最小。CompressMaxは処理能力を犠牲にして圧縮率を高めます。 |
| 一般的な | Default、 Max | エンジンのデフォルト設定と、最大全体最適化レベル |
のために PDFs ウェブサイトで提供される、 web そしてステップアップして WebMax テスト後も最初のページの読み込み遅延が依然として問題となる場合に限る。
API ボディフィールド
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| jobIdExt | Optional | Your own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string. | |
| integrations | Optional | Integration identifiers, forwarded unchanged with the job's notification settings. Type: array. | |
| isAsync | Optional | Set to `true` to process the action asynchronously and get a job to poll at `/api/v2/GetActionStatus`. Only honoured by actions that support asynchronous processing. Type: boolean. | true |
| docName | Optional | Source file name including its extension. Several actions dispatch on the extension, so it should always be set; when omitted a per-action default is used. Type: string. | document.pdf |
| docContent | Required | The source file. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference to a previously uploaded blob, or an `https` URL to the source document. Required: an empty value fails with `File is empty`. Type: string. | JVBERi0xLjcK... |
| docContentBytes | Optional | Alternative raw byte payload for the source file. Type: string. | |
| callBackUrl | Optional | Optional URL notified when an asynchronous job completes. Type: string. | |
| optimizeProfile | Optional | Compression profile. `Default` is mapped to `Max` server-side. An unrecognised value fails with 400 `Invalid Optimization Profile`. Type: string. | web |
サンプルペイロード
ウェブ表示用に線形化
{
"docContent": "JVBERi0xLjcKJb...",
"docName": "report.pdf",
"optimizeProfile": "web"
}
大きなファイル、非同期
{
"docContent": "JVBERi0xLjcKJb...",
"docName": "catalog-2026.pdf",
"optimizeProfile": "WebMax",
"async": true
}
郵便配達員の集荷に関するヒント
curlの例
curl -X POST https://api.pdf4me.com/api/v2/LinearizePdf \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"docContent": "'"$(base64 -w 0 report.pdf)"'",
"docName": "report.pdf",
"optimizeProfile": "web"
}' \
--output linearized.pdf
何が API 戻る？
| 分野 | タイプ | 内容物 |
|---|---|---|
200 response body | Binary (application/pdf) | The linearized PDF as raw bytes. Save it directly. The official samples also handle a JSON-wrapped Base64 fallback, but binary is the primary contract. |
202 Location header | URL | Async mode only: the polling URL. GET it about every 10 seconds (samples: 10 retries) until it returns 200 with the PDF bytes. |
4xx/5xx response body | JSON or text | Error details: 400 for malformed Base64 or an unknown optimizeProfile value, 401 for a missing or invalid API key, 500 for server-side processing failures. |
コードサンプル
このエンドポイントの公式実行可能サンプルは、 language:
よくある質問
線形化する必要があるのはなぜか PDFs ウェブサイト向けですか？
標準 PDF ディレクトリ情報はファイルの末尾に保存されるため、ビューアはページ1をレンダリングする前に基本的にすべてをダウンロードする必要があります。線形化 PDF規範的付属文書として定義される ISO 32000仕様ディレクトリと最初のページを先頭に移動して、増分アクセスを可能にします HTTPドキュメントポータルまたは CDNこれにより、数秒間の空白の待ち時間が、残りのページがストリーミング表示される間に最初のページが表示される状態に変わります。