ولّد فواتير ومستندات PDF حقيقية عبر الـ API — القالب، الأقسام، والتنزيل، كلها برمجياً.
نفس محرّك الفواتير الذي يولّد فواتير المنصة — هيدر EL OUATINE الموحّد، ثنائي اللغة FR+EN.
عنوان + أقسام (ترويسة ونص) بتخطيط نظيف يحمل علامة EL OUATINE وأرقام صفحات.
المستندات المقدَّرة بأكثر من 50 صفحة تُعالَج في الخلفية — تابع الحالة عبر /jobs/:id وحمّل النتيجة.
200 توليد شهرياً مجاناً لكل مفتاح. تجاوز الحصة → 429. الفشل لا يستهلك شيئاً.
✅ 200 توليد PDF شهرياً مجاناً — لكل مفتاح API — تتجدد كل شهر.
🚫 عند تجاوز الحصة يعود الـ API بالرمز 429 — بدون رسوم خفية.
📩 تحتاج حصة أعلى؟ تواصل عبر المنصة.
POST /api/pdf/v1/create — المصادقة عبر Authorization: Bearer أو X-API-Key.
بصدق: لا دمج ملفات PDF (لا qpdf على الخادم) — كل طلب يولّد مستنداً واحداً. خطوط pdfkit لاتينية فقط: النص العربي يظهر كـ «؟».
| POST | /api/pdf/v1/create{ "template": "invoice", "data": { "number": "INV-1", "customer_name": "Client", "description": "Unlock", "amount": 12.5, "currency": "USD" } } |
| POST | /api/pdf/v1/create{ "template": "custom", "data": { "title": "Report", "sections": [{ "heading": "Summary", "body": "…" }] } } |
| GET | /api/pdf/v1/jobs/123→ { "ok": true, "job": { "status": "done", "download_url": "/api/pdf/v1/jobs/123/file" } } |
| الحقل | الوصف |
|---|---|
template | مطلوب — «invoice» أو «custom». |
data (invoice) | قالب invoice: {number, customer_name, description, amount, currency} (+ حقول اختيارية: customer_phone, status, due_date, paid_at, created_at, lang). |
data (custom) | قالب custom: {title, sections:[{heading, body}], footer?} — حتى 200 قسم. |
auth | المصادقة: رأس Authorization: Bearer elopdf_… أو X-API-Key. |
resp | الاستجابة: application/pdf مباشرة (أو 202 + job_id للمستندات الضخمة). |
منصة EL OUATINE — خدمات تقنية للهاتف والبرمجيات.
اكتشف المنصة