\begin{pdf-api}
واجهة API لتوليد ملفات PDF
تتيح لك واجهة API لتوليد ملفات PDF تجميع المستندات برمجيًا بطلب HTTP واحد دون الحاجة إلى أدوات محلية. يوفر FormaTeX واجهة REST API قائمة على LaTeX تنتج ملفات PDF بجودة النشر من أي لغة أو إطار عمل أو أداة أتمتة.
\section{Definition}
ما هي واجهة API لتوليد ملفات PDF؟
واجهة API لتوليد ملفات PDF هي خدمة REST تقبل مصدر المستند (HTML أو LaTeX أو Markdown أو قالبًا) وتعيد ملف PDF مجمَّعًا كاستجابة ثنائية. وبدلًا من تثبيت أدوات PDF على كل جهاز يحتاج إلى إنتاج مستندات، ترسل طلب HTTP من أي لغة أو منصة وتتلقى ملف PDF جاهزًا للاستخدام في جسم الاستجابة.
أي لغة وأي منصة
يعمل طلب HTTP POST واحد من Python أو Node.js أو Go أو Ruby أو PHP أو أي أداة بلا برمجة تدعم إجراء HTTP.
لا تثبيت محلي
لا حاجة إلى تثبيت TeX Live أو wkhtmltopdf أو Chrome بلا واجهة أو Puppeteer أو تحديثها أو صيانتها على خوادمك.
مخرجات متوقعة
تنتج واجهة API مُدارة مخرجات متطابقة عبر البيئات. لا مزيد من أخطاء PDF من نوع "يظهر بشكل مختلف في CI".
\section{Comparison}
واجهات PDF القائمة على LaTeX مقابل القائمة على HTML
| الميزة | LaTeX API (FormaTeX) | واجهة HTML إلى PDF |
|---|---|---|
| جودة الطباعة | احترافية: Knuth–Plass وطباعة دقيقة | عرض بمستوى المتصفح |
| الرياضيات | amsmath أصلي ودعم كامل للمعادلات | حل بديل عبر MathJax/KaTeX |
| التحكم في تخطيط الصفحة | دقيق: الهوامش والأعمدة والترويسات والتذييلات | تقريب عبر CSS وخصوصيات في الطباعة |
| المستندات الطويلة | فهرس المحتويات والمراجع المتقاطعة وقائمة المراجع | يصعب إدارتها بموثوقية |
| الخطوط | دعم كامل لخطوط OTF/TTF مع xelatex/lualatex | محدودة بخطوط النظام/الويب |
| صيغة المصدر | LaTeX (.tex) | HTML + CSS |
| تعقيد الإعداد | منحنى أولي أعلى، ومردود كبير | مألوف إن كنت تعرف HTML/CSS |
| الأنسب لـ | التقارير والأوراق البحثية والفواتير والشهادات | الإيصالات البسيطة ولقطات صفحات الويب |
\section{FormaTeX}
نهج FormaTeX
يشغّل FormaTeX توزيعة TeX Live كاملة في بيئة معزولة على جانب الخادم. يحصل كل طلب تجميع على صندوق رمل جديد: لا تداخل بين المهام، ولا ملفات مساعدة قديمة، ولا خطر أمني من شيفرة LaTeX التي يقدمها المستخدم. يُعاد ملف PDF المجمَّع كبايتات خام في استجابة HTTP ثم يُحذف من خوادمنا.
التجميع المتزامن
أرسل POST إلى /api/v1/compile واستلم بايتات PDF مباشرةً في الاستجابة. مثالي للتوليد عند الطلب حيث تحتاج إلى الملف فورًا.
ثلاثة محركات LaTeX
اختر pdflatex (سريع وأوسع توافقًا) أو xelatex (Unicode وخطوط النظام) أو lualatex (البرمجة النصية بـ Lua وطباعة متقدمة).
تجميع مؤقت
تُحذف شيفرة LaTeX المصدرية وملف PDF المجمَّع من خوادمنا فور إرسال الاستجابة. لا يُخزَّن شيء.
مصادقة بسيطة
مرّر مفتاح API في الترويسة X-API-Key. أنشئ ما تحتاجه من المفاتيح من لوحة التحكم وألغِها فرديًا.
\section{بداية سريعة}
جمّع أول ملف PDF لك في 30 ثانية
نفّذ أمر curl هذا بعد استبدال YOUR_API_KEY بمفتاح FormaTeX الخاص بك. يحفظ الخيار --output hello.pdf بايتات PDF الخام في ملف داخل المجلد الحالي.
curl -X POST https://api.formatex.io/api/v1/compile \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"latex": "\\documentclass{article}\n\\begin{document}\n\\title{Hello, FormaTeX!}\n\\author{Your Name}\n\\date{\\today}\n\\maketitle\n\nThis PDF was generated via the FormaTeX API.\n\n\\end{document}",
"engine": "pdflatex"
}' \
--output hello.pdf\section{حالات الاستخدام}
ما الذي تبنيه الفرق باستخدام واجهة API لتوليد ملفات PDF
التقارير الآلية
ولّد تقارير تحليلات شهرية أو ملخصات مالية أو لوحات معلومات تشغيلية بصيغة PDF وفق جدول زمني، مع تعبئتها من بيانات حية.
الفواتير والإيصالات
جمّع فواتير احترافية من بيانات نظام الفوترة. يتعامل LaTeX بدقة مع بنود الأعمدة المتعددة والإجماليات وأقسام الضرائب.
شهادات الإتمام
ولّد شهادات إتمام مخصصة لمنصات التعلم الإلكتروني. أدرج الأسماء وعناوين الدورات والتواريخ ديناميكيًا.
الأوراق الأكاديمية والأطروحات
جمّع الأوراق البحثية وبحوث المؤتمرات والأطروحات بتنسيق LaTeX الكامل: قوائم المراجع والمعادلات والأشكال وكل شيء.
\section{FAQ}
الأسئلة الشائعة
هل أحتاج إلى معرفة LaTeX لاستخدام FormaTeX؟
LaTeX الأساسي بسيط في المستندات الشائعة. يتيح لك الـ playground في FormaTeX التجريب تفاعليًا. وفي سير العمل المدعوم بالذكاء الاصطناعي، يمكنك استخدام GPT-4 أو Claude لتوليد شيفرة LaTeX المصدرية، وكل ما عليك كتابة الطلب.
ما محركات LaTeX التي يدعمها FormaTeX؟
يدعم FormaTeX محرك pdflatex (الأسرع والأوسع توافقًا مع الحزم) وxelatex (نصوص Unicode وخطوط OpenType) وlualatex (البرمجة النصية بـ Lua وطباعة متقدمة). حدّد المحرك في جسم الطلب.
كم يستغرق التجميع؟
تُجمَّع المستندات البسيطة في أقل من ثانية. أما المستندات المعقدة ذات الحزم الكثيرة أو أشكال TikZ أو قوائم المراجع فتُجمَّع عادةً في ثانيتين إلى خمس ثوانٍ.
هل تُخزَّن شيفرة LaTeX المصدرية بعد التجميع؟
لا. تُحذف شيفرة LaTeX المصدرية وملف PDF المجمَّع من خوادمنا فور إرسال استجابة HTTP. لا يُحفظ شيء.
هل يمكنني استخدام أي حزمة من CTAN؟
نعم. يشغّل FormaTeX تثبيت TeX Live كاملًا. أي حزمة متاحة على CTAN متاحة في بيئة التجميع لديك دون أي إعداد.
\end{pdf-api}
ابدأ توليد ملفات PDF عبر API
سجّل حسابًا مجانيًا في FormaTeX، واحصل على مفتاح API، وجمّع أول ملف PDF بأمر curl واحد، دون الحاجة إلى بطاقة ائتمان.