v2026.05 · واجهة إنشاء PDF من JSON

أسرع واجهة برمجة تطبيقات (API) في العالم للفواتير والملصقات ذات الحجم الكبير

100 ألف صفحة مقابل 5 دولارات. تُنشأ ملفات PDF على الحافة خلال بضعة ميلي ثانية

مصممة للنطاق العالمي متوافقة تمامًا مع متطلبات الفوترة الإلكترونية PDF/A و Factur-X و ZUGFeRD

جرب الواجهة الحية عرض مرجع الواجهة بدون بطاقة ائتمان · بدون تثبيت · صديق لـ curl
CPU / عرض (p50)
4.98ms · 24h
الطلبات المخدومة
299/ 24h
التكلفة
$5 / 100K
المناطق
300+ pops
أكثر من 30 تنسيق باركود 4 ملفات تعريف PDF/A 100K صفحة من $5/شهر
Playground

أرسل JSON. أنشئ PDF.
القدرات الأساسية، كلها في صفحة واحدة.

عدّل DocumentRequest على اليسار. استدعِ عامل الحافة المباشر
مخطط حقيقي، وPDF حقيقي، عادةً <5 ms.

لماذا gPdf

gPdf مبني على أربع ركائز.

01 / 04
$5
per 100K pages

التكلفة

يعمل على Cloudflare Workers — وليس على حاوية Chromium بحجم 800 MB تُحاسَب بـ $0.40/ساعة وهي خاملة. $0.00005 لكل صفحة. لا حدود دنيا، لا رسوم لكل مقعد، لا رسوم لكل بيئة.

02 / 04
PDF/A
1b · 2b · 3b · 4

المعايير

ملفات الأرشفة PDF/A (1b, 2b, 3b, 4) عند الطلب. دعم أصلي لـ Factur-X و ZUGFeRD و EN 16931 — القسم 5 من مرجع API، وليس رابطًا على خارطة الطريق.

03 / 04
JSON → PDF
API + editor, one schema

JSON أصلي

pages[]، elements[]، x/y بالمليمتر. لا HTML→PDF، لا headless Chrome، لا DSL قوالب لتتعلمها. نفس الـ JSON يغذي الـ API والمحرر المرئي — يحرر المصممون والمطورون نفس الملف.

04 / 04
3000+
color emoji, embedded

الطباعة

اللاتينية والصينية واليابانية والكورية والعربية (RTL + تشكيل معقد) والديفاناغاري والسيريلية والبنغالية والتايلاندية مدمجة في المحرك — بالإضافة إلى 3000+ إيموجي ملون. لا حاجة لـ `apt install fonts-noto-cjk`. لا حرف مفقود أبدًا.

الميزات

التفاصيل الأساسية والمهمة، منفذة بشكل صحيح.

دلالات مستند حقيقية، وليس لقطات شاشة المتصفح في غلاف PDF.

Browse use cases
/01

تحكم على مستوى البكسل

x/y بالمليمتر، x_anchor للمحاذاة إلى الحافة اليمنى، تموضع دون المليمتر على الملصقات. إحداثيات، وليست تقريبات.

// inside elements[i]
"x_anchor": {
  "reference": "content_right",
  "offset": 6
}
/02

باركود متجه

أكثر من 30 رمزية بما في ذلك GS1-128 وQR وPDF417 وDataMatrix. كلها vector. طول الباركود الكلي دقيق حتى 0.1 mm.

// 30+ formats: code128, qrcode, datamatrix, pdf417, ...
"type": "barcode",
"format": "code128",
"content": "INV-2026-001"
Why vector beats raster
/03

سلسلة احتياطية للخطوط

font_mode: strict (يجب أن تغطي العائلة المعلنة كل المحارف)، prefer (احتياطي عبر العائلات المدمجة)، auto (المحرك يختار). نفاد auto/prefer يُعيد API-504 — فشل صريح، لا صامت.

// inside style{}
"font_family": "NotoSans-Regular",
"font_mode": "prefer"
/04

أوضاع الامتثال

settings.profile = "pdfa-3b" يُفعّل امتثال PDF/A-3b وتيار مرفقات XML المضمن الذي يطلبه Factur-X / ZUGFeRD. حقل واحد، وثيقة متوافقة واحدة.

// top-level on DocumentRequest
"settings": {
  "profile": "pdfa-3b"
}
PDF/A and Factur-X, explained
/05

متغيرات + ترقيم الصفحات

{page} / {total_pages} يحلان بعد التخطيط. keep_together وwidow/orphan وpage_break blocks.

// element of type "variable"
{ "type": "variable",
  "name": "page",
  "scope": "system" }
/06

جداول تُرقّم الصفحات

row_span عبر الصفحات، repeat headers، alternate_fill، compound double borders. ذلك الـ 1% الذي ينكسر دائمًا.

// inside table element
"pagination": {
  "keep_spans_together": true
}
/07

JSON واحد، واجهتان

نفس JSON DocumentRequest يُشغّل POST /api/v1/pdf/render والمحرر المرئي على editor.gpdf.com. حرر بصريًا، أرسل عبر API، أو اكتب يدويًا — كل المسارات الثلاثة تدور حول نفس الملف.

// three routes, one engine
POST /api/v1/pdf/render
POST /api/v1/template-render
POST /api/v1/e-invoice/render
Read the API reference
/08

مبني للفواتير

$0.00005 لكل page، p50 3 ms، CJK مدمج، PDF/A-3 attachment stream. الأرقام الأربعة التي تفحصها فرق fintech وERP وtax-compliance أولًا.

// invoice — header + table pattern
{ "size": "a4",
  "elements": [
    { "type": "text",  "x": 18, "y": 22, ... },
    { "type": "table", "x": 18, "y": 60, ... }
  ]}
Why JSON beats HTML→PDF
/09

مبني لملصقات الشحن

إعدادات الحجم label_100_150 وlabel_4_6_in. Vector GS1-128 وITF-14 وSSCC بدقة 0.1 mm — تطبع carriers و3PLs في الذروة بلا rasterised barcodes.

// 4×6 thermal shipping label
{ "size": "label_4_6_in",
  "elements": [{
    "type": "barcode",
    "format": "code128",
    "content": "1Z999AA10123456784" }]}
Shipping-label use case
Benchmarks · sampled 2026-04-29

مقاسة، ليست تسويقية.

فاتورة A4 من صفحة واحدة، 12 بندًا، QR + شعار. وسيط 1000 عملية إنشاء PDF. الأقل أفضل.

Methodology: 1-page A4 invoice · 12 line items · 1 QR + 1 logo · 1K invocations · median (p50) and p99 reported. Sampled 2026-04-29 from a workstation in EU-WEST. PDFShift, DocRaptor, Puppeteer and LaTeX numbers are reproduced from each vendor's published quickstart sample with the same input — re-run on your own workload before deciding. Read the head-to-head comparisons →

0 105ms 210ms 315ms 420ms
01 gPdf ours
3.8ms
02 PDFShift
95ms
03 DocRaptor (Prince)
180ms
04 Puppeteer (headless)
312ms
05 LaTeX (local)
420ms
الأسعار

ادفع للصفحات. لا شيء آخر.

لا per-seat. لا per-environment. لا support-tier gatekeeping.

تتضمن جميع paid tiers نفس 100,000 pages ونفس render limits. تختلف فقط في metadata customisation، وتوفر PDF/A profiles، وper-overage rate.

Free Trial

/free
$0 إلى الأبد

100 صفحة / يوم · يتوقف عند الحصة.

  • +100 صفحة / يوم · إعادة تعيين تلقائية
  • +Playground + تقييم API
  • +بدون بطاقة مطلوبة
  • +دعم البريد الإلكتروني · SLA يوم عمل واحد
جرب Playground

Basic

/basic
$5 / شهر

100,000 صفحة / شهر مشمولة.

  • +100,000 صفحة / شهر مشمولة
  • +تجاوز $0.00005 لكل صفحة
  • +بيانات وصفية PDF قياسية · غير قابلة للتخصيص
  • +PDF قياسي فقط · لا ملفات تعريف PDF/A
  • +دعم البريد الإلكتروني · SLA يوم عمل واحد
اشترك

Pro

/pro
$8 / شهر

100,000 صفحة / شهر مشمولة. بيانات وصفية مخصصة.

  • +100,000 صفحة / شهر مشمولة
  • +تجاوز $0.00008 لكل صفحة
  • +العنوان · الموضوع · المنشئ قابلة للتخصيص
  • +PDF قياسي فقط · لا ملفات تعريف PDF/A
  • +دعم البريد الإلكتروني · SLA يوم عمل واحد
اشترك

Enterprise

/ent
$12 / شهر

100,000 صفحة / شهر مشمولة. PDF/A + بيانات وصفية كاملة.

  • +100,000 صفحة / شهر مشمولة
  • +تجاوز $0.00012 لكل صفحة
  • +جميع 6 حقول البيانات الوصفية قابلة للتخصيص الكامل
  • +PDF/A-1b · 2b · 3b · 4 ممكّنة
  • +دعم البريد الإلكتروني · SLA يوم عمل واحد
اشترك
نشر خاص

هل تحتاج إلى تشغيل gPdf داخل محيطك الخاص؟

للفرق الخاضعة للمتطلبات التنظيمية، وعمليات نشر private cloud/VPC، وبيئات intranet المعزولة. يمكن تشغيل gPdf كـ Worker مخصص أو server أو deployment خلف gateway؛ ويتم تحديد ضوابط الشبكة، ومتطلبات المنطقة، وشروط DPA، وتصعيد الدعم حسب كل مشروع.

  • +Private cloud أو VPC أو شبكة معزولة
  • +نشر Worker/server مخصص
  • +شروط DPA وضوابط إقامة البيانات
  • +نموذج الدعم يُتفق عليه مسبقًا
للتواصل بشأن النشر الخاص · soon
أسئلة شائعة

أسئلة يطرحها المطورون فعليًا.

اثنا عشر إجابة — مقتبسة حرفيًا بواسطة JSON-LD FAQPage التي تستهلكها نتائج Google الغنية.

/01

ما مدى سرعة عرض gPdf لملف PDF؟

p50 هو 3 مللي ثانية وp99 هو 8 مللي ثانية على صفحة A4 واحدة، تم قياسه على 1000 استدعاء. إجمالي زمن الجدار على الحافة، بما في ذلك الشبكة، يكون عادة 8 إلى 15 مللي ثانية.

/02

ما تنسيق الإدخال الذي تقبله الواجهة البرمجية؟

جسم DocumentRequest بصيغة JSON. الصفحات والعناصر والطبقات والعلامات المائية والرؤوس والتذييلات والجداول كلها معبّر عنها بنيويًا — بلا HTML، بلا Markdown، وبلا مرحلة تخطيط في المتصفح.

/03

كيف يقارن gPdf بـ Puppeteer أو Chrome headless؟

Headless Chromium يعمل بـ 200-800 مللي ثانية لكل render ويحتاج حاوية 800 ميغابايت. gPdf يعرض نفس صفحة A4 في 3 مللي ثانية داخل V8 isolate بحجم 1 ميغابايت، بلا cold start. المقايضة هي input format: يأخذ gPdf JSON DocumentRequest، وليس raw HTML.

/04

ما هي نقاط نهاية واجهة gPdf البرمجية؟

ثلاثة: /api/v1/pdf/render يأخذ DocumentRequest كاملاً للتحكم على مستوى البكسل. /api/v1/template-render يأخذ template_id مع data array للأنظمة التي لديها template منشور. /api/v1/e-invoice/render ينتج فواتير Factur-X / ZUGFeRD hybrid. الثلاثة يشاركون نفس engine وrate limits وerror-code surface.

/05

هل أحتاج إلى تثبيت خطوط على خادمي للصينية واليابانية والكورية؟

لا. NotoSans CJK مدمج وسلسلة fallback تلقائية تعالج المحارف المفقودة. لن ترى tofu boxes، ولا تحتاج إلى apt install fonts-noto-cjk على runtime.

/06

ما الباركودات التي يمكنني عرضها؟

أكثر من 30 رمزية بما في ذلك QR وGS1-128 وPDF417 وDataMatrix وAztec وMaxiCode وCode 128. كلها vector. يقع طول الباركود الكلي ضمن 0.1 mm من الحجم المطلوب — بدقة كافية لعروض الملصقات المحددة في GS1 وITF-14.

/07

هل ينتج gPdf مخرجات متوافقة مع PDF/A أو الفاتورة الإلكترونية؟

نعم. PDF/A-1b و2b و3b و4 قابلة للاختيار لكل طلب. تدفقات مرفقات Factur-X وZUGFeRD مدعومة لسيناريوهات الفاتورة الإلكترونية.

/08

هل يمكن لـ gPdf إنتاج فواتير Factur-X أو ZUGFeRD أو EN 16931؟

نعم. اضبط settings.profile على pdfa-3b وأرفق حمولة XML المنظمة كتدفق ملف. Factur-X وZUGFeRD يعتمدان على PDF/A-3 — وهو مطلوب للتفويض الألماني للفواتير الإلكترونية، ولتفويض B2B الفرنسي بدءًا من سبتمبر 2026.

/09

أين يعمل gPdf فعليًا؟

داخل V8 isolates لـ Cloudflare Workers. لا حاوية Chromium، لا Lambda warming، ولا document persistence بعد الطلب.

/10

هل يخزن gPdf ملفات PDF أو بيانات الإدخال الخاصة بي؟

لا. Renderer عديم الحالة. يعيش DocumentRequest الخاص بك في V8 isolate لبضعة milliseconds أثناء render ثم يختفي. لا توجد في gPdf caching layer ولا document store — statelessness هي contract وليست opt-in toggle.

/11

هل توجد طبقة مجانية؟

نعم. Free Trial يعطي 100 pages يوميًا، بدون بطاقة ائتمان. يعاد ضبطه يوميًا ويتوقف عند quota — بلا surprise bill. تبدأ paid tiers من $5 شهريًا مقابل 100,000 pages.

/12

كيف أبدأ باستخدام gPdf؟

افتح playground أعلاه، عدّل DocumentRequest، ثم اضغط إنشاء PDF — يعيد live edge worker ملف PDF حقيقيًا. انسخ curl snippet إلى terminal لاستدعائه من أي مكان. لا يتطلب playground تثبيتًا ولا بطاقة ائتمان؛ الحساب مطلوب فقط لإصدار API key الخاص بك.

من المدونة

مقالات هندسية طازجة.

عرض جميع المنشورات
  1. اختيار واجهة PDF في 2026: ثمانية أسئلة يجب طرحها

    إطار محايد لاختيار واجهة توليد PDF. ثمانية أسئلة تكشف إن كنت ستظل راضيا بعد 12 شهرا.

  2. gPdf مقابل DocRaptor: لماذا يتفوق العرض على الحافة على HTML-to-PDF

    يستخدم DocRaptor محرك Prince لتحويل HTML إلى PDF على backend مستضاف. يعرض gPdf JSON المنظم مباشرة على حافة Cloudflare. فرق السعر 18×، وهذا ليس عرضًا مؤقتًا.

  3. شرح PDF/A و Factur-X للمهندسين بدون لغة قانونية

    ما الذي تقيّده ملفات PDF/A فعليًا، ولماذا يصبح Factur-X مهمًا لفوترة أوروبا الإلكترونية، وأصغر مسار عملي للامتثال من عارض JSON.

الثقة

الامتثال وإقامة البيانات

هندسة قابلة للتدقيق بالإضافة إلى الأعمال الورقية — كلا السجلين، وكلاهما قابل للتحقق.

SOC2

SOC 2 Type II

تدقيق مجدول Q3 2026 · دليل عند الطلب.

GDPR

GDPR + DPA

بنود تعاقدية قياسية متاحة عند الطلب.

REGION

إقامة البيانات

خيارات إقامة البيانات في EU وUS وAPAC وSA. تُحدد متطلبات المنطقة في العقد.

STATELESS

عديم الحالة افتراضيًا

لا يوجد document persistence. لا توجد caching layer أو document store في المنتج.

BENCHED

Benchmarks عامة

منافسون مذكورون بالاسم، منهجية كاملة، تاريخ العينة. كل benchmark في هذه الصفحة قابل لإعادة الإنتاج — أعد تشغيله على workload الخاص بك قبل القرار.

DETERMINISTIC

حتمي

Same input → byte-identical PDF. Diffable. Testable في CI بدون snapshot drift.