تُرجمت هذه الصفحة آليًا. هل لاحظت خطأً؟ساعد في تحسينها.
Skip to content

أداة PDF متعددة ​

تجميع ملف PDF من خطة صفحات صريحة: إعادة ترتيب الصفحات، أو تكرارها، أو تدويرها، أو حذفها، وسحب صفحات من ملفات PDF إضافية، كل ذلك في طلب واحد.

نقطة نهاية API ​

POST /api/v1/tools/pdf/multi-tool-pdf

يقبل بيانات نموذج multipart مع ملف PDF واحد أو أكثر وحقل JSON settings. يُدعم ما يصل إلى 20 مستنداً مدخلاً و1,200 صفحة خرج لكل طلب.

المعاملات ​

المعاملالنوعمطلوبالوصف
itemsarrayنعمخطة صفحات الخرج، بترتيب الخرج. كل عنصر هو { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc يفهرس الملفات المرفوعة بترتيب الرفع (ابتداءً من 0)؛ page هو رقم صفحة (ابتداءً من 1) في ذلك المستند.
pageCountsarrayنعمالعدد الحقيقي لصفحات كل مستند مرفوع، بالترتيب نفسه. تُرفض صفحة في الخطة تتجاوز عدد صفحات مستندّها برمز 400.

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

خذ الصفحات 3 و1 من المستند الأول، ثم الصفحات 1 و2 من الثاني، مع تدوير أول صفحة خرج 90° باتجاه عقارب الساعة:

bash
curl -X POST http://localhost:1349/api/v1/tools/pdf/multi-tool-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"items":[{"doc":0,"page":3,"rot":90},{"doc":0,"page":1},{"doc":1,"page":1},{"doc":1,"page":2}],"pageCounts":[3,2]}'

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

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document_multi-tool.pdf",
  "originalSize": 2450000,
  "processedSize": 2450000
}

ملاحظات ​

  • يمكن أن تظهر نفس الصفحة عدة مرات في items لتكرارها.
  • الصفحات غير الموجودة في items تُحذف من الخرج.
  • rot يسجّل اتجاه العرض الجديد على الصفحة المنسوخة (مُركّباً مع أي تدوير موجود)؛ محتوى الصفحة لا يُمس.
  • يُطبَّق التدوير لكل نسخة خرج، لذا يمكن أن يكون للنسخ المكررة تدويرات مختلفة.
  • الخرج هو مستند جديد مسطّح؛ الإشارات المرجعية (bookmarks) والبيانات الوصفية على مستوى المستند لا تُحتفظ بها.
  • تتطلب المعالجة الملف الثنائي qpdf، الذي يُشحن في صورة Docker الرسمية.