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

قسّم PDF كل N صفحات إلى ملفات متتالية

قسّم ملف PDF كل N صفحات عندما تحتاج إلى تحويل مستند طويل إلى سلسلة واضحة من الملفات الأصغر.

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

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

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

اختاروا عددا مناسبا من الصفحات لكل ملف

تحدد القيمة N الحد الأقصى لعدد صفحات المصدر المتتالية في كل ملف PDF ناتج. فعلى سبيل المثال، يؤدي تقسيم مستند من إحدى عشرة صفحة عندما تساوي N أربعة إلى إنشاء ملفات للصفحات 1–4 و5–8 و9–11. يكون الملف الأخير أقصر لأن العدد الإجمالي لا يقبل القسمة على أربعة دون باق؛ ولا تضيف الأداة صفحات فارغة ولا تحذف أي صفحة من المصدر. اختاروا N وفقا للنظام الذي سيستقبل الملفات. فقد تفرض بوابة المستندات حدا عمليا، أو ينتج مسار المسح نموذجا كل صفحتين، أو توزع عملية المراجعة حزما من عشر صفحات. يجب أن تكون N عددا صحيحا لا يقل عن واحد. تنشئ القيمة واحد ملف PDF لكل صفحة، بينما تنشئ القيمة التي تساوي عدد صفحات المصدر أو تزيد عليه ملفا واحدا فقط. يتحكم هذا الإعداد في عدد الصفحات لا في حجم الملف بالبايت، ولذلك قد تختلف أحجام الأجزاء كثيرا رغم تساوي عدد صفحاتها.

اقرؤوا حدود كل جزء وتحققوا منها

يتضمن كل جزء منشأ ملف PDF الخاص به وعدد صفحاته وموضعي البداية والنهاية الشاملين ضمن المستند الأصلي. يبدأ ترقيم هذه المواضع من واحد، أي إن أول صفحة ظاهرة في المصدر هي الصفحة 1. تعرض الاستجابة العامة أيضا عدد صفحات المصدر والقيمة المقبولة لعدد الصفحات في كل جزء وعدد الملفات المنشأة. تتيح هذه الحقول لعملية مؤتمتة التحقق من الاكتمال من دون إعادة فتح كل مستند. يجب أن يبدأ كل جزء متتال في الصفحة التالية لنهاية الجزء السابق؛ ويبدأ الجزء الأول في الصفحة 1 وينتهي الجزء الأخير عند العدد الإجمالي المعلن. تحافظ العملية على الترتيب ولا تجعل الأجزاء متداخلة، كما لا تغير قيمة المصدر الأصلية. من المفيد الجمع بين معرف المستند وحدود الصفحات في اسم الملف، مثل report-pages-001-010.pdf. وبذلك يبقى الناتج مفهوما خارج استجابة API، وتقل الأخطاء عند رفع الملفات أو إرفاقها أو أرشفتها أو إرسالها إلى المراجعين.

استخدموا التقسيم الثابت بأمان في سير العمل

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

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

إعداد حزم للمراجعة

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

فصل النماذج الممسوحة

قسّموا ملف مسح يضم نماذج ثابتة الطول عندما يتكون كل نموذج دائما من العدد نفسه من الصفحات.

تسهيل مسارات رفع الملفات

قسّموا دليلا طويلا إلى مجموعات متوقعة للأنظمة أو العمليات التي تتعامل بسهولة أكبر مع المستندات الصغيرة.

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

ماذا يحدث إذا لم يقبل عدد الصفحات القسمة على N؟

يحتوي ملف PDF الأخير على الصفحات المتبقية، ويكون أقصر من N صفحات من دون حشو أو حذف.

هل يمكن أن تكون N صفرا أو عددا سالبا؟

لا. يجب أن تكون N عددا صحيحا لا يقل عن 1؛ وتعيد القيم الأصغر خطأ إدخال.

هل تحافظ الأداة على ترتيب الصفحات؟

نعم. تكون الأجزاء متتالية وغير متداخلة، وتظهر بالترتيب نفسه الموجود في ملف PDF الأصلي.

هل تتحكم N في حجم الملفات بالميغابايت؟

لا. تتحكم N في عدد الصفحات لكل PDF، وقد يتغير الحجم بحسب الصور والخطوط ومحتوى الصفحات.

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

سعر API هو $0.002 لكل طلب، وقد تتضمن الاستجابة عدة ملفات PDF متتالية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/split-every-n

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

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

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

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

import os, requests

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

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/split-every-n", 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","n":2}',
  ],
]));
$task = json_decode($res, true);

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

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

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