ForHosting KIT · المستندات وملفات PDF

افحص خطية PDF وحالة العرض السريع على الويب

خطية PDF هي ترتيب بنيوي يتيح لعارض متوافق إظهار الصفحة الأولى بينما يستمر تنزيل بقية المستند البعيد.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

يستقبل هذا الفاحص العلامة المنطقية للخطية التي تنتجها أداة فحص PDF، ثم يحولها إلى نتيجة موجزة صالحة للإدراج في تقرير. ويوضح ما إذا كان الملف يعلن دعم العرض السريع على الويب، ويشرح الأثر العملي، ويميز تحسين التسليم من صلاحية الملف، ويقترح الخطوة التالية المناسبة من دون رفع ملف PDF نفسه أو إعادة كتابته.

اقرأ العلامة البنيوية قراءة صحيحة

قد تعرض أداة فحص PDF الخطية في صورة علامة منطقية، وأحيانا إلى جانب تسميات مثل العرض السريع على الويب أو محسن للويب. أدخل النتيجة البنيوية نفسها في الحقل linearized: تعني true أن قاموس الخطية والترتيب المتوقعين قد جرى التعرف إليهما، بينما تعني false أن الملف لا يعلن هذا التنظيم. يطلب الفاحص العلامة صراحة ولا يخمنها من اسم الملف أو حجمه أو سرعة تنزيله أو تسمية في البيانات الوصفية. فهذه القرائن غير المباشرة لا تثبت كيفية ترتيب الكائنات داخل المستند. تعيد النتيجة القيمة المنطقية بعد توحيدها، وتوفر حالة ثابتة لمسارات العمل الآلية، وتصوغ ملخصا عربيا واضحا يناسب التقرير الفني. إذا لم تتضمن نتيجة الفحص العلامة، فلا تستبدلها بالقيمة false. غياب الملاحظة يعني أن الحالة مجهولة، أما false فهي نتيجة بنيوية محددة. لذلك تعيد القدرة خطأ في الإدخال عندما تغيب العلامة أو لا تكون منطقية، وبذلك تمنع دخول استنتاج بلا سند إلى سجل تدقيق أو ضبط جودة.

افهم أثر العرض السريع على الويب

يضع ملف PDF الخطي المعلومات اللازمة للعرض المبكر قرب بداية الملف، ويتضمن تلميحات تساعد القارئ المتوافق على طلب نطاقات البايت المفيدة. عندما يستضيف الملف خادم يدعم طلبات النطاق، قد يعرض المتصفح أو عارض PDF المتوافق الصفحة الأولى قبل وصول جميع البايتات. ويمكن أن يحسن ذلك سرعة الاستجابة المتصورة مع المستندات الكبيرة والاتصالات البطيئة ولدى من يحتاج إلى الصفحات الأولى فقط. يستخدم التقرير صياغة دقيقة لأن العلامة البنيوية تهيئ شرطا ممكنا ولا تضمن مستوى أداء بعينه. كما يعتمد السلوك الفعلي على تسليم HTTP والتخزين المؤقت وزمن الشبكة وطريقة تنفيذ العارض وتعقيد المستند والتحويلات اللاحقة في مسار المحتوى. لا تضغط الخطية ملف PDF، ولا تقلل عدد صفحاته، ولا تصدق إمكانية الوصول، ولا تتحقق من التوقيعات، ولا تثبت أن المستند سليم من جميع الجوانب. وبالمثل، قد يفتح ملف غير خطي بسرعة إذا كان صغيرا أو مخزنا مؤقتا. لذلك ينبغي أن تصف النتيجة الاستعداد للتسليم التدريجي، لا أن تدعي زيادة مقيسة في السرعة.

استخدم النتيجة في تقرير أو مسار عمل

عند ظهور نتيجة إيجابية، سجل أن ملف PDF خطي ويدعم العرض السريع على الويب، واحتفظ بالتنبيه إلى أن ظروف التسليم تحدد الفائدة المشاهدة. وعند ظهور نتيجة سلبية، اذكر أن العرض السريع غير معلن وأن إظهار الصفحة الأولى عن بعد قد يتطلب تنزيل جزء أكبر من الملف. لا تصف المستند بأنه تالف، فالملفات غير الخطية شائعة وقد تكون صالحة تماما. التوصية مشروطة: اجعل الملف خطيا عندما يكون العرض التدريجي عبر HTTP مهما، ثم افحص الناتج المعاد كتابته مرة أخرى. فالتحرير أو التحسين أو التوقيع أو الدمج أو إعادة الإنشاء قد يغير الترتيب الداخلي ويحذف بنية خطية كانت صالحة. في النشر الآلي، نفذ الفحص البنيوي بعد آخر خطوة تنتج المستند، ومرر علامته المنطقية هنا، واحفظ الحالة والشرح العائدين مع أدلة الإصدار. كما تسهل الحقول الثابتة تطبيق السياسات: يمكن لمسار نشر الويب أن يشترط true، بينما يقبل مسار الأرشفة أو التوزيع المحلي القيمتين ويحفظ النتيجة للمعلومية فقط.

حالات الاستخدام

توثيق فحص النشر على الويب

حول العلامة البنيوية الصادرة عن أداة الفحص إلى نتيجة متسقة قبل نشر ملف PDF كبير على موقع ويب.

توحيد مخرجات ضبط الجودة

حول true أو false إلى حقول حالة ثابتة ونص تقرير تستطيع الفحوص اللاحقة حفظه ومقارنته.

شرح النتيجة السلبية بدقة

وضح أن غياب تحسين العرض السريع يؤثر في التسليم التدريجي، لكنه لا يعني وحده أن ملف PDF غير صالح.

الأسئلة الشائعة

ما الإدخال الذي يحتاج إليه الفاحص؟

يحتاج إلى علامة الخطية المنطقية من فحص بنية PDF، أي true أو false. ولا يعامل العلامة الغائبة أو المجهولة على أنها false.

هل تفحص هذه القدرة ملف PDF أو ترفعه؟

لا. إنها تفسر علامة بنيوية أنتجتها مسبقا خطوة أخرى لفحص PDF.

هل يفتح ملف PDF الخطي بسرعة أكبر دائما؟

لا. فهو يتيح التسليم التدريجي، لكن التجربة الفعلية تعتمد على الخادم والعارض والاتصال والتخزين المؤقت وتعقيد المستند وحجمه.

هل ملف PDF غير الخطي تالف؟

لا. غياب الخطية نتيجة تخص تحسين التسليم، وليس دليلا على التلف أو عدم الصلاحية.

هل يمكن أن يزيل التحرير الخطية؟

نعم. قد تغير إعادة الكتابة أو الدمج أو التوقيع أو التحسين ترتيب الكائنات، ولذلك افحص الناتج النهائي مرة أخرى.

ما تكلفة طلب API؟

يكلف كل طلب API مبلغ $0.002. ويمكن لإصدار المتصفح تنفيذ التفسير الحتمي نفسه محليا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/linearize-check

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر 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"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←