/01
ما مدى سرعة عرض gPdf لملف PDF؟
p50 هو 3 مللي ثانية وp99 هو 8 مللي ثانية على صفحة A4 واحدة، تم قياسه على 1000 استدعاء. إجمالي زمن الجدار على الحافة، بما في ذلك الشبكة، يكون عادة 8 إلى 15 مللي ثانية.
أسئلة شائعة
أسئلة يطرحها المطورون فعليًا.
اثنا عشر إجابة — مقتبسة حرفيًا بواسطة JSON-LD FAQPage التي تستهلكها نتائج Google الغنية.
/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 الخاص بك.