الباركود والتجزئة

API باركود PDF417 للمستندات والملصقات PDF

اعرض باركود PDF417 داخل ملفات PDF للوجستيات والتذاكر ومستندات شبيهة ببطاقات الصعود وسير المستندات، بينما يملك نظامك قواعد البيانات المشفرة.

API الرئيسي JSON Render
مسار API /api/v1/pdf/render
الأنظمة خادم خلفي لوجستي / خادم خلفي للتذاكر / سير عمل سفر / خدمة أتمتة مستندات
المهمة المطلوبة

عرض بيانات PDF417 كعناصر PDF متجهية داخل ملصقات أو تذاكر أو نماذج أو مستندات شبيهة ببطاقات الصعود، مع بقاء الصيغة المشفرة والتحقق اللاحق ضمن مسؤولية نظامك.

متى تستخدم هذه API

  • تحتاج إلى باركود PDF417 مضمّن داخل مستند PDF أو ملصق.
  • لدى نظامك البيانات المشفرة النهائية ويعرف متطلبات الماسحات اللاحقة.
  • تحتاج إلى تخطيطات PDF417 متكررة عبر Template Render.
  • تريد مخرجات PDF بدل صورة باركود مستقلة.

ما الذي لا تستبدله

  • تحتاج إلى أن يعتمد gPdf صيغ بيانات شركات الطيران أو الحكومة أو اللوجستيات أو الصناعة.
  • تحتاج إلى منطق مخزون التذاكر أو تعيين المقاعد أو حجز السفر.
  • تحتاج إلى إدارة عتاد الماسحات.

أي مسار API يجب استدعاؤه

الرئيسي

/api/v1/pdf/render

JSON Render هو المسار الافتراضي لسير العمل هذا.

ثانوي 1

/api/v1/template-render

استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.

طلب مختصر

POST /api/v1/pdf/render - باركود PDF417 على صفحة بنمط تذكرة.

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 14,
          "content": "Boarding pass sample",
          "style": { "font_size": 14, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "pdf417",
          "content": "M1DOE/JOHN         EABC123 JFKLAX GP 042 001A0001 100",
          "x": 10,
          "y": 38,
          "width": 80,
          "height": 28
        }
      ]
    }
  ]
}

ما يتولاه gPdf

  • عرض باركود PDF417 متجهيًا داخل مخرجات PDF.
  • تخطيط المستند أو الملصق حول الباركود.
  • ربط القالب لتخطيطات التذاكر أو اللوجستيات المتكررة.
  • استجابة PDF ثنائية عبر واجهات العرض العامة.

ما يبقى ضمن مسؤولية نظامك

  • بيانات PDF417 المشفرة وقواعد الصناعة وحالة التذكرة أو الشحنة وهوية العميل.
  • قبول الماسحات واختبار الطباعة الفعلية ومنع الاحتيال.
  • أي عملية حجز أو وصول أو لوجستيات لاحقة يطلقها الباركود.

قائمة فحص الإنتاج

  1. تحقق من بيانات PDF417 مع الماسح أو نظام الشريك الذي سيستهلكها.
  2. اطبع وامسح بالحجم والمواد المستخدمة في الإنتاج.
  3. أبق البيانات الحساسة خارج الباركود إلا إذا كان سير الوجهة يتطلبها.
  4. استخدم Template Render للتخطيطات المتكررة المعتمدة.
  5. سجّل معرّفات الطلب مع معرّف التذكرة أو الشحنة أو المستند.

حدود الادعاءات

  • يعرض gPdf باركود PDF417؛ ولا يعتمد صيغ بيانات الصناعة.
  • تبقى دلالات التذاكر والسفر والهوية واللوجستيات ضمن مسؤوليتك.
  • يبقى التحقق الفعلي من المسح مطلوبًا.

PDF417 هو الباركود، وليس عملية الأعمال

يظهر PDF417 كثيرًا في التذاكر والسفر والهوية واللوجستيات. يستطيع gPdf عرض الباركود داخل PDF. أما صيغة البيانات، وفحوص الهوية، وحالة الحجز، والقبول اللاحق فتبقى خارج API العرض.

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

هل يدعم gPdf PDF417؟
نعم. يتضمن enum تنسيقات الباركود العام أسماء pdf417 و MicroPDF417.
هل يستطيع gPdf إنشاء بيانات بطاقة صعود للطيران؟
لا. يعرض gPdf قيمة PDF417 التي ترسلها. يملك نظام السفر أو التذاكر لديك بناء البيانات.
هل يمكن استخدام PDF417 مع Template Render؟
نعم. استخدم Template Render عندما يجب أن يقبل التخطيط المتكرر بيانات الباركود والأعمال فقط.
هل أحتاج إلى اختبار المسح؟
نعم. يجب التحقق من عمليات PDF417 باستخدام الماسحات المستهلكة ومواد الطباعة الإنتاجية.