API أدوات PDF

نقاط وصول لدمج وتقسيم وضغط وتحويل وحماية ومعالجة ملفات PDF. جميع نقاط الوصول تقبل multipart/form-data وتُرجع الملف المعالج كتحميل ثنائي.

دمج PDF

POST/api/pdf-merge

ادمج عدة ملفات PDF في مستند PDF واحد. يتم دمج الملفات بترتيب رفعها.

Parameters

Name	Type	Required	Description
`files`	File[]	Required	عدة ملفات PDF للدمج

Response:ملف PDF مدمج

bash

curl -X POST https://freefiletools.io/api/pdf-merge \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

تقسيم PDF

POST/api/pdf-split

قسّم ملف PDF إلى أجزاء متعددة بناءً على نطاقات الصفحات. يُرجع ملف ZIP يحتوي على ملفات PDF المقسمة.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتقسيم
`ranges`	string	Required	نطاقات الصفحات، مثال: "1-3,5,7-9". كل نطاق يصبح ملف PDF منفصل.

Response:ملف ZIP يحتوي على ملفات PDF المقسمة

bash

curl -X POST https://freefiletools.io/api/pdf-split \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "ranges=1-3,5,7-9" \
  -o split-pages.zip

ضغط PDF

POST/api/pdf-compress

اضغط ملف PDF لتقليل حجمه. يستخدم Ghostscript للضغط عالي الجودة.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للضغط
`level`	string	Optional	مستوى الضغط: "low"، "medium"، أو "high". الافتراضي: "medium"

Response:ملف PDF مضغوط

bash

curl -X POST https://freefiletools.io/api/pdf-compress \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "level=high" \
  -o compressed.pdf

PDF إلى Word

POST/api/pdf-to-word

حوّل ملف PDF إلى مستند Microsoft Word (.docx).

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتحويل

Response:ملف DOCX

bash

curl -X POST https://freefiletools.io/api/pdf-to-word \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.docx

PDF إلى صور

POST/api/pdf-to-image

حوّل صفحات PDF إلى صور. يُرجع ملف ZIP يحتوي على صورة واحدة لكل صفحة.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتحويل
`format`	string	Optional	تنسيق الصورة: "png"، "jpg"، أو "webp". الافتراضي: "png"
`dpi`	number	Optional	الدقة بـ DPI. الافتراضي: 150

Response:ملف ZIP يحتوي على صور

bash

curl -X POST https://freefiletools.io/api/pdf-to-image \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "format=png" \
  -F "dpi=300" \
  -o pages.zip

PDF إلى Excel

POST/api/pdf-to-excel

حوّل ملف PDF إلى جدول بيانات Microsoft Excel (.xlsx). يعمل بشكل أفضل مع ملفات PDF التي تحتوي على بيانات جدولية.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتحويل

Response:ملف XLSX

bash

curl -X POST https://freefiletools.io/api/pdf-to-excel \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.xlsx

PDF إلى PowerPoint

POST/api/pdf-to-ppt

حوّل ملف PDF إلى عرض تقديمي Microsoft PowerPoint (.pptx).

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتحويل

Response:ملف PPTX

bash

curl -X POST https://freefiletools.io/api/pdf-to-ppt \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o presentation.pptx

Word إلى PDF

POST/api/word-to-pdf

حوّل مستند Microsoft Word (.docx) إلى PDF.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف .docx للتحويل

Response:ملف PDF

bash

curl -X POST https://freefiletools.io/api/word-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document.pdf

PowerPoint إلى PDF

POST/api/ppt-to-pdf

حوّل عرض تقديمي Microsoft PowerPoint (.pptx) إلى PDF.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف .pptx للتحويل

Response:ملف PDF

bash

curl -X POST https://freefiletools.io/api/ppt-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o presentation.pdf

Excel إلى PDF

POST/api/excel-to-pdf

حوّل جدول بيانات Microsoft Excel (.xlsx) إلى PDF.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف .xlsx للتحويل

Response:ملف PDF

bash

curl -X POST https://freefiletools.io/api/excel-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o spreadsheet.pdf

حماية PDF

POST/api/protect-pdf

احمِ ملف PDF بكلمة مرور. سيتطلب ملف PDF الناتج كلمة مرور لفتحه.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للحماية
`password`	string	Required	كلمة المرور لتعيينها على PDF

Response:ملف PDF محمي بكلمة مرور

bash

curl -X POST https://freefiletools.io/api/protect-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "password=mysecretpassword" \
  -o protected.pdf

فتح قفل PDF

POST/api/unlock-pdf

أزل حماية كلمة المرور من ملف PDF. يتطلب كلمة المرور الحالية.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF محمي بكلمة مرور
`password`	string	Required	كلمة المرور الحالية لـ PDF

Response:ملف PDF غير مقفل

bash

curl -X POST https://freefiletools.io/api/unlock-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "password=mysecretpassword" \
  -o unlocked.pdf

تدوير PDF

POST/api/rotate-pdf

دوّر جميع صفحات ملف PDF بزاوية محددة.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتدوير
`angle`	number	Required	زاوية التدوير: 90، 180، أو 270 درجة

Response:ملف PDF مُدوّر

bash

curl -X POST https://freefiletools.io/api/rotate-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "angle=90" \
  -o rotated.pdf

علامة مائية على PDF

POST/api/watermark-pdf

أضف علامة مائية نصية إلى جميع صفحات ملف PDF.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF لإضافة علامة مائية
`text`	string	Required	نص العلامة المائية المراد إضافته

Response:ملف PDF بعلامة مائية

bash

curl -X POST https://freefiletools.io/api/watermark-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "text=CONFIDENTIAL" \
  -o watermarked.pdf

OCR PDF

POST/api/ocr-pdf

طبّق التعرف البصري على الحروف (OCR) على ملف PDF ممسوح ضوئيًا، مما يجعل النص قابلاً للتحديد والبحث. يستخدم محرك Tesseract OCR.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF ممسوح ضوئيًا
`language`	string	Optional	لغة OCR: "eng" (الإنجليزية)، "tur" (التركية)، "deu" (الألمانية)، إلخ. الافتراضي: "eng"

Response:ملف PDF قابل للبحث

bash

curl -X POST https://freefiletools.io/api/ocr-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "language=eng" \
  -o searchable.pdf

إصلاح PDF

POST/api/repair-pdf

محاولة إصلاح ملف PDF تالف أو معطوب.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF تالف

Response:ملف PDF مُصلَح

bash

curl -X POST https://freefiletools.io/api/repair-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o repaired.pdf

قص PDF

POST/api/crop-pdf

اقصص جميع صفحات ملف PDF، مع إزالة المساحات البيضاء أو القطع إلى منطقة محددة.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للقص

Response:ملف PDF مقصوص

bash

curl -X POST https://freefiletools.io/api/crop-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o cropped.pdf

إضافة أرقام الصفحات

POST/api/page-numbers

أضف أرقام صفحات إلى جميع صفحات ملف PDF.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF

Response:ملف PDF بأرقام صفحات

bash

curl -X POST https://freefiletools.io/api/page-numbers \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o numbered.pdf

صورة إلى PDF

POST/api/img-to-pdf

حوّل صورة واحدة أو أكثر إلى ملف PDF. كل صورة تصبح صفحة واحدة.

Parameters

Name	Type	Required	Description
`files`	File[]	Required	ملفات صور (JPG، PNG، WebP)

Response:ملف PDF

bash

curl -X POST https://freefiletools.io/api/img-to-pdf \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o images.pdf

PDF إلى PDF/A

POST/api/pdf-to-pdfa

حوّل ملف PDF إلى تنسيق PDF/A للأرشفة طويلة المدى. يستخدم Ghostscript للتحويل.

Parameters

Name	Type	Required	Description
`file`	File	Required	ملف PDF للتحويل

Response:ملف PDF/A

bash

curl -X POST https://freefiletools.io/api/pdf-to-pdfa \
  -H "x-api-key: fft_your_api_key" \
  -F "[email protected]" \
  -o document-pdfa.pdf