API ملفات PDF: الدمج والتقسيم والتدوير والضغط
ادمج عدة ملفات PDF، واستخرج الصفحات، ودوّر ملفات PDF واضغطها في السحابة عبر نقطة نهاية واحدة.
إجابة مختصرة
أرسل POST /api/v1/pdf-job/ مع قيمة operation من بين merge أو split أو rotate أو compress. مرّر sourceKeys (بالترتيب) لعملية merge، أو sourceKey واحدًا للعمليات الأخرى؛ تأخذ split في "pages" أرقام صفحات تبدأ من الصفر، وتأخذ rotate قيمة "degrees" تساوي 90 أو 180 أو 270. تأتي الملفات من رفع مباشر، والنتيجة مهمة PDF جديدة تستعلم عنها كأي مهمة أخرى.
العمليات
يجب أن تكون الملفات موجودة مسبقًا في تخزين حسابك: ارفعها أولًا واستخدم قيم objectKey المُرجعة.
| operation | المدخلات | حقول إضافية |
|---|---|---|
| merge | sourceKeys: عدد 2 أو أكثر من ملفات PDF، بالترتيب | — |
| split | sourceKey | pages: مصفوفة تبدأ من الصفر، فمثلًا [0, 1, 4] تحتفظ بالصفحات 1 و2 و5 |
| rotate | sourceKey | degrees: 90 أو 180 أو 270 |
| compress | sourceKey | — (ملف التعريف "ebook" في Ghostscript، وصور بدقة 150 dpi) |
دمج ملفي PDF مرفوعين
لدمج ملفات PDF الموجودة على الإنترنت، أرسل POST /api/v1/merge/ مع مصفوفة "files" تضم 2–20 رابط PDF بالترتيب. تكلفته 1 رصيد ويعيد ملف PDF المدمج مباشرة في الرد بدلًا من مهمة، وهو أمر مفيد في أدوات البرمجة دون كود.
curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pack-8812-merge' \
-d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'الحدود والسلوك
يمكن أن يصل حجم كل ملف إدخال إلى 100 MB، وحجم المهمة إلى 150 MB إجمالًا. يعيد الضغط كتابة الصور بدقة 150 dpi تقريبًا، وهو ما يناسب البريد الإلكتروني والرفع؛ وقد لا يتقلص حجم ملفات PDF النصية الصغيرة أصلًا كثيرًا. ويجب فك قفل ملفات PDF المشفرة أولًا.
الأسئلة الشائعة
هل تبدأ أرقام الصفحات من الصفر؟
في API نعم: [0] هي الصفحة الأولى. أما أدوات الموقع فتستخدم ترقيمًا يبدأ من 1.
هل يمكنني الضغط إلى حجم محدد بدقة؟
ليس عبر نقطة النهاية هذه، فهي تطبّق ملف تعريف متوازنًا واحدًا؛ ويوفر الموقع أداة للضغط إلى حجم معيّن عندما تحتاج إلى قيمة دقيقة.