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

ترتيب صفحات PDF على الوجهين

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

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

عدد الصفحات: 5
وضع الطباعة على الوجهين: long_edge

تحصل على

عدد الأوراق: 3

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

ماذا يعني الوجهان بالحافة الطويلة والقصيرة لترتيب الصفحات

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

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

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

معاينات السائق والواجهة

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

تكامل مستمر لأنابيب الطباعة

أكد تعيينات ورقة-وجه مستقرة في اختبارات آلية كلما تغيّرت إعدادات الوجهين أو أعداد الصفحات في سير عمل المستندات.

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

ماذا يحدث إذا كان عدد الصفحات صفراً؟

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

ما الفرق بين القلب على الحافة الطويلة والقصيرة؟

على الحافة الطويلة تُقلب الورقة من اليسار إلى اليمين كالكتاب ويبقى الظهر معتدلًا. وعلى الحافة القصيرة تُقلب من الأعلى إلى الأسفل كالتقويم، فيظهر الظهر مقلوبًا بزاوية 180 درجة بالنسبة إلى الوجه.

هل يغيّر نمط القلب الصفحة التي تقع على كل وجه؟

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

ماذا يحدث عندما يكون عدد الصفحات فرديًا؟

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

لماذا تخرج الصفحات الزوجية مقلوبة؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/duplex-page-order-check

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

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

curl -X POST https://api.kit.forhosting.com/pdf/duplex-page-order-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":5,"duplex_mode":"long_edge"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/duplex-page-order-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_count": 5,
    "duplex_mode": "long_edge"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/duplex-page-order-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 5,
    "duplex_mode": "long_edge"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/duplex-page-order-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_count":5,"duplex_mode":"long_edge"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_count":5,"duplex_mode":"long_edge"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/duplex-page-order-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "page_count": 5,
  "duplex_mode": "long_edge"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.duplex_page_order_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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

يُرفض العدد صفر برمز invalid_input. المنطق النقي نفسه يغذي الأداة المجانية في المتصفح ومسار API بسعر $0.002 لكل طلب ناجح، فلا يختلف التخطيط والإنتاج حول أي صفحة تقع على أي وجه.

ماذا يعني الوجهان بالحافة الطويلة والقصيرة لترتيب الصفحات

عندما يكون العدد فردياً يكون للورقة الأخيرة وجه أمامي مطبوع وخلف فارغ: يبلغ الفاحص بذلك عبر blank_back_last بقيمة true ويحذف back_page من كائن تلك الورقة بدل اختراع صفحة وهمية. يعلّم وضع long_edge (مع مرادفات أسلوب الكتاب) كل الأوجه upright: اقلب الورقة على حافتها الطويلة فيُقرأ الخلف دون تدوير الورق مئة وثمانين درجة. يعلّم وضع short_edge (مرادفات التقويم) كل خلف rotated_180: اقلب على الحافة القصيرة فيصبح محتوى الخلف مقلوباً بالنسبة إلى الأمام إن أمسكت الرزمة دون ذلك القلب.

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

تُرفض الأعداد السالبة أيضاً. اربط الاستجابة بأدوات N-up أو فرض الكتيّب إن احتجت فرضاً يتجاوز الاقتران المزدوج البسيط؛ هذه النقطة تجيب فقط ترتيب الورقة والوجه للطباعة المزدوجة القياسية. أرسل جسماً JSON بحقلين مطلوبين. page_count عدد صحيح غير سالب (مرادفات pages وn وcount)؛ يجب أن يكون عدداً صحيحاً لأنك لا تطبع كسراً من الصفحة. duplex_mode سلسلة تُطبَّع إلى long_edge أو short_edge (مرادفات mode وflip وbinding). تشمل تهجئات الحافة الطويلة المقبولة long_edge وlong-edge وlongedge وflip_long وlong وbook؛ والقصيرة short_edge وshort-edge وshortedge وflip_short وshort وcalendar. الحقول الناقصة والأعداد غير المنتهية وغير الصحيحة والأوضاع المجهولة تفشل بـ invalid_input دون فوترة. يُرفض page_count صفر برسالة واضحة تطلب عدداً موجباً — لا خريطة أوراق للمستندات الفارغة. عند النجاح يعيد الجسم page_count وduplex_mode المعياري، ويبلّغ sheet_count وblank_back_last، ويسرد pages ككائنات تحوي page وsheet وside (front أو back) وorientation (upright أو rotated_180)، ويسرد sheets مع sheet وfront_page ومع back_page وback_orientation اختياريين عند وجود خلف، ويتضمن summary قصيراً للسجلات والواجهة. مثال: خمس صفحات في long_edge تعطي ثلاث أوراق، الصفحات من واحد إلى خمسة أمام-خلف-أمام-خلف-أمام، blank_back_last true وكل الاتجاهات upright. الخمس نفسها في short_edge تحافظ على اقتران الأوراق لكن تعلّم الصفحتين الثانية والرابعة rotated_180.

أين تثبت واجهة ترتيب صفحات الوجهين قيمتها

تستفيد مواقع التعليم والتوثيق التي تنافس على ترتيب صفحات الطباعة المزدوجة من أداة حية يطابق مسارها المجاني مسار الأتمتة المدفوع بايتًا بايتًا على الوحدة النقية نفسها. فرق الإتاحة والتشطيب التي تقلب الرزم النهائية لفحص التجليد يمكنها إظهار الصفحات التي ستظهر معكوسة في short-edge قبل تحميل الدرج. لأن التنفيذ تحليل parse من الطبقة A، كل استدعاء ناجح يكلف السعر الأساسي المنشور دون رموز نموذج ولا شبكة صادرة؛ التحقق الفاشل لا يستهلك الرصيد. تستخدم غرف الطباعة وخدمات الطباعة المُدارة فاحص ترتيب الصفحات على الوجهين قبل إطلاق مهام بمئات الصفحات ليؤكد المشغّلون المخزون (sheet_count) وما إذا احتاجت الورقة الأخيرة خلفاً فارغاً. يمكن لأتمتة المكاتب التي تطبع الفواتير أو الحزم على الوجهين أن تؤكد blank_back_last والاتجاه في الاختبارات بدل الاعتماد على عينة مادية كلما تغيّر إعداد مسبق للسائق. مؤلفو أنابيب PDF الذين يعرضون مفاتيح long-edge مقابل short-edge في واجهة يمكنهم معاينة خريطة الأوراق مجاناً في المتصفح ثم استدعاء العقد نفسه من عامل بسعر $0.002 لكل طلب ناجح عند وضع المهمة في الطابور.

حالات التكامل

تخطيط الأوراق قبل الطباعة

حوّل عدد صفحات PDF ووضع القلب المختار إلى sheet_count وأزواج أمام/خلف وعلامات خلف فارغ قبل تحميل الورق أو ضبط برنامج التشغيل.

أسئلة تقنية

كيف أتحقق من ترتيب صفحات طباعة PDF على الوجهين؟

أرسل page_count (عدداً صحيحاً موجباً) وduplex_mode (long_edge أو short_edge). تعيد API ورقة كل صفحة ووجهها واتجاهها مع خريطة أمام/خلف لكل ورقة.

ما الفرق بين الحافة الطويلة والحافة القصيرة؟

الوضعان يقرنان الصفحات بالطريقة نفسها (1–2 على الورقة 1، 3–4 على 2، …). long_edge يبقي الخلف upright؛ short_edge يعلّمه rotated_180 (قلب بأسلوب التقويم).

ماذا لو كان لملفي PDF عدد صفحات فردي؟

يبقى sheet_count هو ceil(page_count/2). الورقة الأخيرة لها أمام فقط؛ blank_back_last true ويُحذف back_page من تلك الورقة.

كم يكلف فاحص ترتيب صفحات الوجهين؟

أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقاً بسعر $0.002 لكل استدعاء ناجح؛ الإدخال غير الصالح لا يُفوتر.

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

شغّل الأداة مجانًا

مثال محلول

ماذا يعني الوجهان بالحافة الطويلة والقصيرة لترتيب الصفحات

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

معاينات السائق والواجهة

تكامل مستمر لأنابيب الطباعة

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

ماذا يعني الوجهان بالحافة الطويلة والقصيرة لترتيب الصفحات

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

أين تثبت واجهة ترتيب صفحات الوجهين قيمتها

حالات التكامل

تخطيط الأوراق قبل الطباعة

أسئلة تقنية

شكرًا