الباركود والتجزئة
API QR code داخل PDF للمستندات والملصقات
اعرض QR codes داخل ملفات PDF للإيصالات والتذاكر والملصقات وحزم onboarding وسير البحث عن المستندات باستخدام JSON Render أو القوالب.
API الرئيسي JSON Render
مسار API
/api/v1/pdf/render الأنظمة خادم خلفي SaaS / خادم خلفي للتجارة الإلكترونية / خادم خلفي للتذاكر / خدمة أتمتة مستندات
المهمة المطلوبة
وضع QR codes داخل مستندات PDF أو ملصقات أو إيصالات أو تذاكر أو نماذج حتى يستطيع المستخدمون مسح رابط أو معرّف أو رمز بحث يسيطر عليه نظامك.
متى تستخدم هذه API
- لدى نظامك URL أو token أو معرّف طلب أو معرّف تذكرة أو قيمة بحث يجب تشفيرها.
- تحتاج إلى رسم QR code داخل PDF بدل تركيبه كصورة نقطية خارجية.
- تحتاج إلى تخطيطات متكررة قائمة على QR عبر Template Render.
- تريد مسار API واحدًا للنص والتخطيط ومخرجات PDF وعرض QR code.
ما الذي لا تستبدله
- تحتاج إلى اختصار URL أو إصدار رموز وصول أو إنشاء روابط دفع من gPdf.
- تحتاج إلى تحليلات ماسحات أو منطق تطبيق جوال.
- تحتاج إلى QR codes خارج مخرجات PDF.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - صفحة مستند تتضمن QR للبحث.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Scan to view this document online",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/documents/DOC-2026-001",
"x": 20,
"y": 44,
"width": 32,
"height": 32
}
]
}
]
}
ما يتولاه gPdf
- عرض باركود QR متجهي داخل مخرجات PDF.
- السياق النصي والتخطيطي وسياق الإيصال أو التذكرة أو الملصق أو المستند حول QR code.
- ربط القوالب لسير QR المتكرر.
- تسليم استجابة PDF عبر واجهات العرض العامة.
ما يبقى ضمن مسؤولية نظامك
- URL أو token المشفر، والتحكم في الوصول، والانتهاء، وسلوك إعادة التوجيه، ووجهة الجوال.
- اختبار الماسحات، ورحلة المستخدم، وقواعد منع الاحتيال.
- أي إجراء دفع أو تذكرة أو مرتجع أو حساب يحدث بعد المسح.
قائمة فحص الإنتاج
- أبق عناوين URL المشفرة مستقرة أو قابلة لإعادة التوجيه طوال عمر المستند.
- اختبر مسافة المسح والتباين والحجم ومواد الطباعة.
- تجنب تضمين بيانات حساسة خام مباشرة داخل بيانات QR.
- استخدم معرّفات الطلب وسجّل كائن الأعمال المرتبط بكل PDF مولد.
- انقل تخطيطات QR المستقرة إلى Template Render.
حدود الادعاءات
- يعرض gPdf QR codes داخل PDF؛ ولا يستضيف الوجهة أو يؤمنها.
- يملك نظامك انتهاء الرموز وإعادة التوجيه والصلاحيات وتجربة المسح.
- QR code ليس نظام دفع أو تذاكر بذاته.
صفحات QR code ما زالت تحتاج إلى دلالات واضحة
QR code هو الحامل المرئي فقط. يعتمد سير الإنتاج على الوجهة أو token الموجود خلفه. يرسم gPdf QR code داخل PDF؛ ويملك نظامك ما يحدث بعد المسح.
الأسئلة الشائعة
- هل ينشئ gPdf صور QR code؟
- يعرض gPdf عناصر باركود QR code داخل مخرجات PDF. الاستجابة العامة هي PDF، وليست خدمة صور مستقلة.
- هل يمكن استخدام QR codes في القوالب؟
- نعم. يمكن أن يتضمن القالب حقول QR، ويرسل المتصلون بيانات المتغيرات.
- من يملك وجهة QR؟
- يملك نظامك عناوين URL والرموز وإعادة التوجيه والصلاحيات وسلوك الانتهاء.
- هل يمكن أن يحتوي QR code على بيانات حساسة؟
- يمكنه تشفير أي شيء ترسله، لكن أنظمة الإنتاج يجب أن تشفر عادةً token بحث أو URL بدل البيانات الحساسة الخام.