PDFのリニアライズと高速Web表示を確認
PDFのリニアライズとは、遠隔にある文書の残りをダウンロードしている途中でも、対応ビューアーが先頭ページを表示できるようにする構造上の配置です。このチェッカーは、PDF検査ツールが出力したリニアライズの真偽値を受け取り、報告書にそのまま記載できる簡潔な判定へ変換します。高速Web表示に対応する構造かを示し、実際の意味を説明するとともに、配信の最適化とファイルの有効性を区別します。PDF自体をアップロードしたり書き換えたりせず、次に行うべき対応も提示します。
無料で実行
構造フラグを正確に読み取ります
PDF検査ツールでは、リニアライズが真偽値のフラグとして表示され、高速Web表示やWeb最適化などの名称が併記される場合があります。その構造検査の結果を、linearizedフィールドへ正確に入力してください。trueは想定されるリニアライズ辞書とオブジェクト順序が認識されたことを示し、falseはファイルがその配置を備えていないことを示します。このチェッカーは、ファイル名、容量、ダウンロード速度、メタデータの表示から推測せず、フラグを必須としています。そのような間接的な情報では、文書内部のオブジェクト配置を確定できないためです。結果には、正規化した真偽値、自動処理で利用できる安定したステータス、技術報告書向けの分かりやすい要約が含まれます。検査結果にフラグがない場合は、falseで代用しないでください。観測値がない場合は状態不明ですが、falseは明確な構造上の判定です。そのため、フラグが欠けている場合や真偽値でない場合には入力エラーを返し、根拠のない結論が監査や品質管理記録へ入ることを防ぎます。
高速Web表示による違いを理解します
リニアライズされたPDFでは、早期表示に必要な情報がファイル先頭付近に置かれ、対応リーダーが必要なバイト範囲を要求するためのヒントも含まれます。ファイルを配信するサーバーが範囲リクエストに対応していれば、対応ブラウザーやPDFビューアーは、すべてのバイトを受信する前に先頭ページを描画できる場合があります。大容量文書、低速回線、先頭の数ページだけを確認する利用者には、応答が速く感じられる可能性があります。ただし、構造フラグは実現条件の一つであり、性能を保証するものではないため、報告文は断定を避けています。実際の動作は、HTTP配信、キャッシュ、ネットワーク遅延、ビューアーの実装、文書の複雑さ、後続処理にも左右されます。リニアライズはPDFを圧縮せず、ページ数を減らさず、アクセシビリティーや署名を証明せず、文書全体の正常性も保証しません。反対に、小容量またはキャッシュ済みの非リニアライズPDFがすぐ開くこともあります。したがって、測定済みの高速化ではなく、段階的配信への対応状況として記録します。
報告書や処理フローで判定を活用します
結果が肯定の場合は、PDFがリニアライズされ、高速Web表示に対応する構造であると記録してください。同時に、実際の効果は配信条件によって決まるという注意事項も残します。否定の場合は、高速Web表示が示されておらず、遠隔で先頭ページを表示するまでにファイルのより多くの部分を受信する可能性があると報告します。ただし、文書が破損しているとは記載しないでください。非リニアライズPDFは一般的で、完全に有効な場合があります。推奨事項には条件があります。HTTPでの段階的表示が重要な場合にファイルをリニアライズし、書き換え後の出力を再検査します。編集、最適化、署名、結合、再生成によって内部順序が変わり、有効だった構造が失われることがあるためです。自動公開では、最後の文書生成工程後に構造検査を実行し、その真偽値をここへ渡して、返されたステータスと説明を公開証跡とともに保存します。Web公開ではtrueを必須とし、保管やローカル配布では両方を情報として許可するなど、安定したフィールドをポリシー判定にも利用できます。
活用例
Web公開前の検査を記録します
大容量PDFをWebサイトへ公開する前に、検査ツールの構造フラグを一貫した判定へ変換します。
品質管理の出力を統一します
trueまたはfalseを安定したステータスと報告文へ変換し、後続の検査で保存や比較ができるようにします。
否定結果を正確に説明します
高速Web表示への未対応は段階的配信に関するものであり、それだけでPDFが無効になるわけではないと明示します。
よくある質問
チェッカーにはどの入力が必要ですか?
PDF構造検査で得たリニアライズの真偽値、つまりtrueまたはfalseが必要です。値がない場合や不明な場合をfalseとして扱うことはありません。
この機能はPDFファイルを検査またはアップロードしますか?
いいえ。別のPDF検査工程ですでに得られた構造フラグを解釈します。
リニアライズ済みなら必ず速く開きますか?
いいえ。段階的配信を可能にしますが、実際の体験はサーバー、ビューアー、回線、キャッシュ、文書の複雑さ、容量によって決まります。
非リニアライズPDFは破損していますか?
いいえ。リニアライズされていないという判定は配信最適化に関するもので、破損や無効性を示す証拠ではありません。
編集によってリニアライズが失われますか?
はい。書き換え、結合、署名、最適化でオブジェクト順序が変わることがあるため、最終成果物をもう一度検査してください。
APIリクエストの料金はいくらですか?
APIリクエスト1回につき$0.002です。ブラウザー版では、同じ決定論的な解釈をローカルで実行できます。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/pdf/linearize-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"linearized":true}'const res = await fetch("https://api.kit.forhosting.com/pdf/linearize-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"linearized": true
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/linearize-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"linearized": true
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/linearize-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"linearized":true}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"linearized":true}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/linearize-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"linearized": true
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.linearize_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_mb | 25 |
max_pages | 200 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |