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

تشخيص إصلاح PDF وخطة الاستعادة

غالبًا ما ينتج ملف PDF التالف قائمة مربكة من رسائل المحلل من دون بيان ما يمكن إصلاحه فعليًا.

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

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

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

حوّلوا رسائل المدقق إلى قرار بشأن الإصلاح

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

تعرّفوا إلى معنى قابلية الإصلاح

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

طبقوا الخطة المرتبة وتحققوا منها

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

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

فرز تقرير التحقق

حوّلوا الملاحظات البنيوية الأولية إلى قائمة متسقة من المشكلات القابلة للإصلاح والمشكلات المعلقة قبل إسناد العمل الفني.

تخطيط مسار الاستعادة

استخدموا التوصيات المرتبة لاختيار مراحل إعادة البناء وفحوص التحقق التي تلي كل تغيير.

توثيق قرار الإصلاح

أرفقوا التصنيفات والمواضع والمخاطر والتوصيات بسجل حادثة أو بسجل استعادة أرشيفية.

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

هل تصلح هذه القدرة ملف PDF نفسه؟

لا. إنها تصنف قائمة مقدمة من الملاحظات البنيوية وتنشئ خطة، ولا تستقبل وحدات بايت ملف PDF أو تعدلها مطلقًا.

ما معنى قابل للإصلاح في التقرير؟

يعني أن إصلاحًا بنيويًا معروفًا يمكن غالبًا اشتقاقه من المعلومات الباقية، لكنه لا يضمن استعادة جميع محتويات المستند.

ماذا يحدث لرسالة تحقق غير معروفة؟

تُصنف على أنها مشكلة بنيوية غير معروفة وغير قابلة للإصلاح آليًا، مع توصية بإجراء فحص يدوي.

لماذا تُرفض قائمة المشكلات الفارغة؟

لا يستطيع التشخيص من دون ملاحظات تصنيف أي شيء أو إنشاء خطة مفيدة، ولذلك يعيد الطلب خطأ إدخال غير صالح.

كم تبلغ تكلفة التقرير؟

تبلغ تكلفة كل طلب API مقدار $0.002. تستخدم القدرة معالجة محلية حتمية من دون نموذج خارجي أو خدمة شبكية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/repair-report

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/repair-report \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issues":[{"description":"Missing cross-reference table","location":"file trailer"},{"description":"Unterminated stream","location":"object 18"}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/repair-report", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "issues": [
      {
        "description": "Missing cross-reference table",
        "location": "file trailer"
      },
      {
        "description": "Unterminated stream",
        "location": "object 18"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/repair-report",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "issues": [
        {
            "description": "Missing cross-reference table",
            "location": "file trailer"
        },
        {
            "description": "Unterminated stream",
            "location": "object 18"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/repair-report", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"issues":[{"description":"Missing cross-reference table","location":"file trailer"},{"description":"Unterminated stream","location":"object 18"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"issues":[{"description":"Missing cross-reference table","location":"file trailer"},{"description":"Unterminated stream","location":"object 18"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/repair-report", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "issues": [
    {
      "description": "Missing cross-reference table",
      "location": "file trailer"
    },
    {
      "description": "Unterminated stream",
      "location": "object 18"
    }
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.repair_report",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 200

الأخطاء

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

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