gPdf
حالات الاستخدام · واجهة API لإنشاء PDF

واجهة API لإنشاء PDF لمستندات الأعمال الديناميكية

هل تبحث عن مولّد PDF؟ gPdf هي واجهة API لتحويل JSON إلى PDF للمطورين الذين يحتاجون إلى إنشاء PDF تلقائيًا وبكميات كبيرة للملصقات والفواتير والتقارير والمستندات الأرشيفية.

المهمة المطلوبة

حوّل بيانات الأعمال إلى ملفات PDF إنتاجية تلقائيًا: ملصقات شحن، فواتير، تقارير، شهادات ومستندات موجهة للعملاء، تُنشأ من JSON داخل تطبيقك من دون مطالبة المستخدمين برفع الملفات يدويًا إلى مولّد PDF على الويب.

لماذا gPdf مناسب هنا

  • إنشاء JSON-to-PDF: عرّف الصفحات والنصوص والصور والجداول والباركود والبيانات الوصفية داخل DocumentRequest منظم واحد.
  • سير عمل محوره API: استدعِ POST /api/v1/pdf/render من الخادم الخلفي أو مشغّل المهام أو نظام المستودع أو منتج SaaS.
  • جاهز للدفعات: أنشئ آلاف أو ملايين ملفات PDF من دون إدارة أسطول متصفحات.
  • خطوط مدمجة للنصوص اللاتينية وCJK والعربية والديفاناغاري والبنغالية والتايلاندية والسيريلية.
  • باركودات متجهة وملصقات ثابتة المقاس لوثائق اللوجستيات والتجارة الإلكترونية والمخزون.
  • خيارات PDF/A والبيانات الوصفية والفواتير الإلكترونية عندما يحتاج المستند الناتج إلى أرشفة أو معالجة امتثال.

طلب عيّنة

POST /api/v1/pdf/render — ملف PDF ديناميكي بسيط يُنشأ من JSON.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

الامتثال والمطابقة

  • تتوفر ملفات تعريف PDF/A عندما يجب أرشفة ملفات PDF الناتجة أو إرفاقها بأدلة تدقيق.
  • يمكن ضبط بيانات المستند الوصفية مباشرة في الطلب نفسه، بحيث تحتفظ ملفات PDF الناتجة بعنوان ومؤلف وموضوع ولغة ثابتة.
  • يمكن استخدام النموذج المنظم نفسه من واجهة API أو من المحرر المرئي في https://studio.gpdf.com.

إذا كنت تحتاج فقط إلى مولّد PDF لمرة واحدة

إذا كان هدفك تحويل مستند Word، أو دمج ملفين، أو تصدير صفحة واحدة إلى PDF، فمولّد PDF عادي على الويب يكفي. هذه الأدوات مصممة للعمل اليدوي: ارفع ملفًا، اضغط زرًا، ثم نزّل النتيجة.

أما gPdf فمبني لمهمة مختلفة: للفرق التي تحتاج إلى أن ينشئ برنامجها ملفات PDF تلقائيًا.

عندما تعني عبارة “مولّد PDF” فعليًا “واجهة API لإنشاء PDF”

مصطلح البحث واسع، لكن متطلبات الإنتاج غالبًا ما تكون محددة:

  1. يضع العميل طلبًا، ويجب على نظامك إنشاء ملصق شحن.
  2. يحتاج منتج SaaS إلى إنشاء كشوف شهرية أو تقارير.
  3. يحتاج سير عمل مالي إلى فواتير ببيانات وصفية وإعدادات أرشفة يمكن توقعها.
  4. يحتاج نظام مستودعات إلى 50,000 ملصق قبل موعد استلام شركة الشحن.
  5. تحتاج أداة دعم إلى إيصال PDF أو شهادة أو تصدير يحمل هوية العلامة.

في كل هذه الحالات، لا يكون السؤال الأساسي: “أي زر ينشئ ملف PDF؟” بل: هل يستطيع الخادم الخلفي لديك إنشاء ملف PDF الصحيح من البيانات، مرارًا وتكرارًا، بسرعة وبتكلفة منخفضة؟

نموذج gPdf: JSON يدخل، وPDF يخرج

يستخدم gPdf نموذج مستند JSON منظمًا. يرسل تطبيقك:

  • مقاس الصفحة وإحداثيات التخطيط،
  • كتل النص واختيارات الخطوط،
  • الصور والباركودات المتجهة،
  • الجداول والبيانات الوصفية وإعدادات المستند،
  • إعدادات PDF/A أو الفاتورة الإلكترونية الاختيارية.

تعيد واجهة API ملف PDF. لا يوجد خادم متصفح يحتاج إلى إحماء، ولا إصدار Chromium يجب تثبيته، ولا محرك تخطيط HTML/CSS داخل المسار الساخن.

لماذا يهم ذلك في إنشاء PDF بالدفعات

أدوات PDF العامة مريحة لشخص واحد. لكنها ليست مبنية لنظام ينشئ المستندات طوال اليوم.

في إنشاء الدفعات، الخصائص المهمة هي:

  • مخرجات حتمية لإعادة الطباعة ومسارات التدقيق،
  • زمن p99 منخفض عندما ترتفع قائمة الانتظار فجأة،
  • تكلفة متوقعة لكل صفحة منشأة،
  • خطوط وهندسة باركود لا تتغير بتغير صور الحاويات،
  • شكل طلب يستطيع المطورون إصداره كنسخ واختباره.

هذا هو عبء العمل الذي يستهدفه gPdf.

ابدأ باستدعاء API بسيط

افتح Playground إذا أردت تجربة نموذج JSON قبل ربطه بالكود. وعندما تكون جاهزًا للتكامل، استخدم مرجع JSON Render API وأرسل الطلب نفسه من الخادم الخلفي لديك.

إذا كان أول عبء عمل لديك في اللوجستيات، فاقرأ أيضًا حالة استخدام ملصقات الشحن. فهي تعرض النمط نفسه مطبقًا على ملصقات حرارية 4×6 وباركودات شركات الشحن والتوليد في أحجام الذروة.

الأسئلة الشائعة

هل gPdf مولّد PDF على الويب؟
ليس بالمعنى الاستهلاكي القائم على رفع ملف وتحويله. gPdf هي واجهة API للمطورين من أجل إنشاء PDF تلقائيًا داخل المنتجات والخوادم الخلفية والأنظمة التشغيلية.
هل يمكنني إنشاء ملفات PDF ديناميكيًا من JSON؟
نعم. يصف DocumentRequest الصفحات والنصوص والصور والباركود والجداول والبيانات الوصفية والإعدادات. يرسل تطبيقك JSON ويتلقى ملف PDF.
متى أستخدم gPdf بدلًا من متصفح headless؟
استخدم gPdf عندما يكون المستند منظمًا ومتكررًا وعالي الحجم: ملصقات، فواتير، تقارير، شهادات ومستندات أعمال مولّدة. يبقى تصيير المتصفح مفيدًا للقطات HTML العشوائية.
هل يستطيع غير المطورين تصميم ملف PDF؟
نعم. يعمل المحرر المرئي في https://studio.gpdf.com بالنموذج JSON نفسه، بحيث يستطيع زميل من العمليات أو التصميم تعديل التخطيط بينما يحافظ المطورون على سير عمل API.

واصل القراءة