واجهة البرمجة للمطورين (API)

نسخة الخادم من المعمل فيها واجهة HTTP بسيطة، لتحويل الملفات من أنظمة المكتب والسكربتات بدون الموقع. متاحة في نسخة الخادم فقط (وليس على GitHub Pages).

المفاتيح

البرامج ترسل مفتاحًا في رأس الطلب ولها حد استخدام خاص أكبر. مدير الخادم ينشئ المفاتيح (python -m app.keys new <الاسم>) ولا يُحفظ منها إلا البصمة. بدون مفتاح يكون الحد هو حد الزائر لكل عنوان IP، والمفتاح الخاطئ يُرفض.

Authorization: Bearer olab_…

تحويل ملف

أرسل الملف كنموذج multipart مع خيارات الأداة بصيغة JSON، والرد هو الملف المحوَّل نفسه.

curl -X POST https://your-server/api/convert/word-to-pdf \
  -H "Authorization: Bearer olab_…" \
  -F "file=@report.docx" \
  -F 'options={"pdfa": true}' \
  -o report.pdf

• GET /api/capabilities — الأدوات التي يستطيع هذا الخادم تشغيلها، وأقصى حجم بالميجا
• POST /api/convert/{tool} — الحقول: file وoptions (JSON)؛ الرد: الملف

الأخطاء

عند الفشل يكون الرد JSON مثل {"code": "too-big"} مع رمز HTTP المناسب. الرموز:

wrong-typetoo-bigpasswordcorruptedbad-optionsbad-keynot-foundbusytimeout

الأدوات (19)

أدوات المتصفح تعمل على جهاز الزائر وليس لها واجهة برمجة: لا شيء يُرسل إلى خادم.