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

أدرج صفحة فارغة في أي موضع داخل ملف PDF

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

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

اختاروا موضع الإدراج بدقة

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

كيف تحصل الصفحة الفارغة على مقاسها

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

جهّزوا إدخالاً متوافقاً وتحققوا من النتيجة

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

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

إضافة ورقة فاصلة

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

ضبط ترتيب الطباعة على الوجهين

أضيفوا صفحة فارغة حيث يلزم كي يبدأ الفصل أو النموذج على الوجه المقصود عند الطباعة المزدوجة.

توفير مساحة للتوقيع أو الملاحظات

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

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

ما المواضع الصالحة؟

استخدموا عدداً صحيحاً من 1 حتى عدد الصفحات الحالي مضافاً إليه واحد. تضيف القيمة الأخيرة الصفحة في النهاية.

ما مقاس الصفحة المستخدم؟

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

هل تحتوي الصفحة الجديدة على أي شيء؟

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

ماذا يحدث إذا كان الموضع خارج النطاق؟

يعيد الطلب خطأ إدخال ولا ينتج ملف PDF معدلاً.

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

تبلغ تكلفة كل طلب $0.002.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/insert-blank-page

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

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

curl -X POST https://api.kit.forhosting.com/pdf/insert-blank-page \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","position":2}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/insert-blank-page",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","position":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/insert-blank-page", 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",
  "position": 2
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.insert_blank_page",
  "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 الكامل ←