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

أنشئ صورة مصغّرة لغلاف ملف PDF

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

● مستقرةلكل طلب · لكل مستند$0.040

تشغيل — $0.040 + $0.001/مستند اطّلع على الـAPI

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

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

لماذا صورة مصغّرة لا الملف كله؟

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

كيف تُنشأ الصورة؟

ترسل ملف PDF عبر الموقع أو الـAPI، فتعيد الأداة صورة واحدة مُصيَّرة من الصفحة الأولى — أو أي صفحة تحددها — بالحجم والصيغة اللذين تختارهما. العملية أخف بكثير من تحويل الملف كاملًا إلى صور، لأنها تعالج صفحة واحدة فقط. هذا الفرق في الحمل الحسابي ينعكس على السرعة والتكلفة معًا: توليد صورة واحدة لآلاف الملفات في أرشيف كبير أسرع وأرخص بكثير من معالجة كل صفحاتها بالكامل لمجرد الحصول على معاينة.

أين تُستخدم عادة؟

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

الفرق بينها وبين تحويل الصفحات كاملة

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

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

معاينة مخططات هندسية بصريًا

مؤسسة النخيل للمقاولات تعرض صورة مصغّرة لكل مخطط هندسي في نظام إدارة المشاريع الداخلي، فيتعرف الموظف على المخطط الصحيح دون فتح عشرات الملفات.

نشرات مواصفات في متجر إلكتروني

متجر إلكتروني تابع لشركة الخليج الرقمية يعرض صورة مصغّرة لكل نشرة مواصفات منتج بصيغة PDF بجانب زر التحميل في صفحة المنتج.

أرشيف عقود قابل للتصفح البصري

فاطمة الزهراني تبني أرشيفًا رقميًا لعقود الشركة وتضيف صورة مصغّرة لكل عقد لتسهيل التصفح البصري بدل قائمة أسماء ملفات فقط.

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

أي صفحة تُستخدم لإنشاء الصورة المصغّرة؟

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

ما حجم الصورة الناتجة؟

تختار العرض بالبكسل عند الطلب؛ الأداة تحافظ على نسب الصفحة الأصلية دون تشويه لضمان وضوح المحتوى في الحجم المصغّر.

هل الملف كاملًا يُرفع لإنشاء صورة واحدة فقط؟

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

كم سعر إنشاء صورة مصغّرة واحدة؟

$0.040 تقريبًا للطلب الواحد، سعر ثابت لكل ملف بصرف النظر عن حجمه ضمن الحدود المسموحة.

هل يمكن توليد آلاف الصور المصغّرة دفعة واحدة لأرشيف كامل؟

عبر الـAPI نعم، ترسل كل ملف في طلب منفصل وتجمّع النتائج آليًا في نظامك؛ لا حد أقصى لعدد الطلبات المتتابعة.

ما الفرق بينها وبين تحويل كل الصفحات إلى صور؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/thumbnail

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

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

curl -X POST https://api.kit.forhosting.com/pdf/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/thumbnail", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/thumbnail",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/thumbnail", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"pdf":"https://ejemplo.com/documento.pdf"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/thumbnail", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "pdf": "https://ejemplo.com/documento.pdf"
}

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

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

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

الأسعار

لكل طلب$0.040

لكل مستند$0.001

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

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

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

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