API V2

إضافة الباركود إلى PDF

حوّل مستندات PDF الخاصة بك باستخدام واجهة برمجة تطبيقات الباركود القوية التي تدعم أكثر من 150 نوعًا من الباركود بما في ذلك رموز QR وCode128 وDataMatrix وAztec وHanxin وPDF417. مثالية لـ أنظمة المخزون و ملصقات الشحن و تتبع المستندات و سير العمل الآلي.

الميزات الرئيسية:

  • 150+ نوع باركود: رمز QR وCode128 وDataMatrix وAztec وHanxin وPDF417 والمزيد
  • تحديد موضع مرن: ضع الباركود في أي مكان على PDF مع تحكم دقيق
  • تنسيقات متعددة: دعم للميليمترات والنقاط للتحكم الدقيق في الحجم
  • خيارات عرض النص: إظهار أو إخفاء نص الباركود، تحديد الموضع أعلى أو أسفل
  • تحكم في الشفافية: تعديل الشفافية لتأثيرات العلامة المائية
  • المعالجة المجمعة: إضافة الباركود لعدة صفحات أو مستندات

حالات الاستخدام الشائعة:

  • التجارة الإلكترونية: كتالوجات المنتجات مع ملصقات الباركود
  • اللوجستيات: ملصقات الشحن ومستندات التتبع
  • الرعاية الصحية: سجلات المرضى وإدارة الأدوية
  • الحكومة: مستندات الهوية ونماذج الامتثال
  • التعليم: بطاقات الطلاب وأنظمة المكتبات

تتكامل واجهة برمجة تطبيقات مولد الباركود هذه بسلاسة مع سير العمل الحالي لديك، وتوفر موثوقية وأداء على مستوى المؤسسات.

  • الطريقة: POST
  • النقطة النهائية: /api/v2/addbarcode

تحقق من طلب API الخاص بك

للوصول إلى واجهة برمجة التطبيقات الويب لـ PDF4me، يجب أن تشمل كل طلب معلومات التحقق المناسبة. التحقق من الهوية يضمن الاتصال الآمن ويتحقق من هويتك كمستخدم مصرح له.


أنواع الباركود المدعومة

واجهة برمجة تطبيقات مولد الباركود الخاصة بنا تدعم 150+ نوع من الباركود، مما يجعلها الحل الأكثر شمولية لدمج الباركود في PDF.

الباركود أحادي البعد (خطي)

  • Code128: الباركود أحادي البعد الأكثر تنوعاً، يدعم جميع أحرف ASCII
  • Code39: باركود أبجدي رقمي، مستخدم على نطاق واسع في اللوجستيات
  • EAN13/EAN8: تعريف المنتجات التجارية الدولية
  • UPC-A/UPC-E: معيار البيع بالتجزئة في أمريكا الشمالية
  • Code93: نسخة محسنة من Code39 بكثافة أفضل

الباركود ثنائي الأبعاد (مصفوفة)

  • رمز QR: الباركود ثنائي الأبعاد الأكثر شيوعاً للمسح المحمول
  • DataMatrix: باركود ثنائي الأبعاد عالي الكثافة، مثالي للعناصر الصغيرة
  • PDF417: باركود خطي مكدس بسعة بيانات كبيرة
  • Aztec: باركود ثنائي الأبعاد مع تصحيح خطأ ممتاز
  • Hanxin: المعيار الوطني الصيني للباركود ثنائي الأبعاد

PDF4me api samples

CSharp(C#)
Java
JavaScript
Python
Salesforce
Google Script
AWS Lambda

معاملات API

قائمة كاملة بمعاملات API إضافة الباركود إلى PDF. المعاملات منظمة حسب الفئة لفهم وتنفيذ أفضل.

محتوى المستندBase64, Required

محتوى مستند PDF المشفر بتنسيق Base64. هذا هو ملف PDF المصدر الذي سيتم إضافة الباركود إليه. يجب أن يكون الملف مستند PDF صالح.

مثال:JVBERi0xLjQKJcOkw7zDtsO8CjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo+PgpzdHJlYW0K...

اسم المستندstring, Required

اسم ملف PDF المصدر. يجب أن يتضمن امتداد .pdf. سيتم استخدام هذا الاسم للرجوع إليه وقد يظهر في رسائل الخطأ.

أمثلة:

  • document.pdf
  • invoice-2024.pdf
  • report-final.pdf
بيانات الباركودstring, Required

البيانات المراد ترميزها في الباركود. يمكن أن يكون نصًا أو أرقامًا أو عناوين URL أو أي سلسلة نصية يدعمها نوع الباركود المحدد. سيتم تحويل البيانات إلى صورة باركود قابلة للمسح.

أمثلة:

  • النص:Hello World
  • الرابط:https://example.com
  • كود المنتج:ABC123456
  • الهاتف:+1-555-123-4567

ملاحظة: أنواع الباركود المختلفة لها حدود سعة بيانات مختلفة وقيود أحرف مختلفة.

نوع الباركودstring, Required

حدد نوع الباركود المراد إنشاؤه. اختر من بين 150+ تنسيق باركود مدعوم، بما في ذلك رموز QR والباركود الخطي ورموز المصفوفة ثنائية الأبعاد.

الأنواع الشائعة:

  • رمز QR:qrCode - الباركود ثنائي الأبعاد الأكثر تنوعاً
  • Code128:code128 - الباركود أحادي البعد العالمي
  • DataMatrix:dataMatrix - الباركود ثنائي الأبعاد عالي الكثافة
  • EAN13:ean13 - كود المنتج الدولي
  • UPC-A:upcA - معيار البيع بالتجزئة في أمريكا الشمالية

انظر إلى القائمة الكاملة لأنواع الباركود المدعومة أعلاه لجميع الخيارات المتاحة.

الصفحات المستهدفةstring, Required

حدد الصفحات التي يجب إضافة الباركود إليها. استخدم اختيار الصفحات المرن مع القيم المفصولة بفواصل والنطاقات.

أمثلة التنسيق:

  • جميع الصفحات:"" (سلسلة فارغة)
  • صفحة واحدة:"0" (الصفحة الأولى)
  • صفحات متعددة:"0, 2, 4"
  • نطاق الصفحات:"1-5" (الصفحات 2-6)
  • مختلط:"0, 2-4, 7" (الصفحة 1، الصفحات 3-5، الصفحة 8)
  • من الصفحة إلى النهاية:"3-" (الصفحة 4 إلى النهاية)

ملاحظة: فهارس الصفحات مبنية على 0 (الصفحة الأولى = 0). إذا لم يتم تحديدها، يتم إضافة الباركود إلى جميع الصفحات.

المحاذاة الأفقيةstring, Required

تحكم في الموضع الأفقي للباركود على الصفحة. هذا يحدد مكان ظهور الباركود أفقياً بالنسبة هوامش الصفحة.

الخيارات:

  • Left - محاذاة إلى الحافة اليسرى للصفحة
  • Center - توسيط أفقي على الصفحة
  • Right - محاذاة إلى الحافة اليمنى للصفحة

مثال:"Center" سيضع الباركود في وسط الصفحة أفقياً.

المحاذاة الرأسيةstring, Required

تحكم في الموضع الرأسي للباركود على الصفحة. هذا يحدد مكان ظهور الباركود عمودياً بالنسبة هوامش الصفحة.

الخيارات:

  • Top - محاذاة إلى الحافة العلوية للصفحة
  • Middle - توسيط عمودي على الصفحة
  • Bottom - محاذاة إلى الحافة السفلية للصفحة

مثال:"Bottom" سيضع الباركود في أسفل الصفحة عمودياً.

ارتفاع الباركود (مم)string, Required

حدد ارتفاع الباركود بالمليمتر. هذا يتحكم في الحجم الرأسي للباركود المُولد.

الارتفاعات الموصى بها:

  • رموز QR: 20-60مم (40مم موصى به)
  • الباركود أحادي البعد: 15-30مم (20مم موصى به)
  • DataMatrix: 10-40مم (20مم موصى به)

التكبير التلقائي: أدخل "0" للسماح للنظام بتحديد الارتفاع الأمثل تلقائياً بناءً على نوع الباركود والبيانات.

مثال:"40" ينشئ باركود بارتفاع 40مم.

العرض بالمليمترstring, Required

عرض الباركود بالمليمتر. ‘0’ للكشف التلقائي.
مثال - 40.

الحواف الأفقية بالنقاطstring, Required

الحواف الأفقية بالنقاط

الحواف الرأسية بالنقاطstring, Required

الحواف الأفقية بالنقاط

الارتفاع بالنقاطString, Required

ارتفاع الباركود بالنقاط (pt). أو ‘0’ للكشف التلقائي.
مثال - 20.

عرض بالنقاطString, Required

عرض الباركود بالنقاط (pt). ‘0’ للكشف التلقائي.
مثال - 20.

الحواف الأفقية بالنقاطString, Required

الهامش من نقطة البداية العلوية للباركود بالنقاط (pt).
مثال - 10.

الحواف الرأسية بالنقاطString, Required

الهامش من نقطة البداية اليسرى للباركود بالنقاط (pt).
مثال - 10.

الشفافيةinteger, Required

أدخل قيمة بين 0 و 100 حيث ‘0’ متماسك تمامًا.
مثال - 100.

عرض النصString, Required

سيتم عرض النص أعلى الباركود -
أعلى
أسفل

إخفاء النصBoolean, Required

اختر ‘true’ لإخفاء نص الباركود و ‘false’ لعرضه بجانب الباركود.

  • true
  • false
عرض فقط في الطباعةBoolean, Required

إذا كنت تريد عرض فقط في الطباعة، فعرض فقط في الطباعة. يمكنك اختيار هاتين الاختيارين.
true
false

هل النص في الأعلىBoolean, Required

إذا كنت تريد هل النص في الأعلى، يمكنك اختيار هاتين الاختيارين.
true
false


الناتج

ترجع واجهة برمجة التطبيقات مستند PDF المعالج مع الرموز الشريطية المدمجة. تتضمن الاستجابة محتوى الملف والبيانات الوصفية للتكامل السهل في سير عمل التطبيق الخاص بك.

محتوى ملفBinary

المحتوى الثنائي لمستند PDF المعالج مع الرموز الشريطية المدمجة. جاهز للتحميل أو المعالجة الإضافية.

اسم الملفString

اسم الملف لمستند PDF المعالج. يمكن تخصيصه أو إنشاؤه تلقائياً بناءً على متطلباتك.

الترويسة
Content-Type: application/json
Authorization: يرجى نسخ المفتاح من الرابط.

Payload

{
  "alignX": "Right",
  "alignY": "Top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "text": "hello",
  "barcodeType": "qrCode",
  "pages": "2",
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "20",
  "widthInPt": "20",
  "marginXInPt": "10",
  "marginYInPt": "10",
  "opacity": 100,
  "displayText": "above",
  "hideText": true,
  "showOnlyInPrint": false,
  "isTextAbove": true
}

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

🛒 التجارة الإلكترونية والتجزئة

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

📦 الخدمات اللوجستية والشحن

  • ملصقات الشحن: إضافة رموز التتبع الشريطية إلى مستندات التسليم لتتبع الطرود
  • تتبع الطرود: إنشاء معرفات فريدة لكل شحنة في سلسلة التوريد
  • إدارة المستودعات: إنشاء الرموز الشريطية لمواقع التخزين وتحديد هوية المنتجات
  • سلسلة التوريد: تتبع المنتجات عبر شبكة التوزيع الكاملة مع الرموز المدمجة

🏥 الرعاية الصحية والطبية

  • سجلات المرضى: إضافة الرموز الشريطية لتحديد هوية المرضى السريع والوصول إلى التاريخ الطبي
  • إدارة الأدوية: إنشاء الرموز الشريطية لتتبع الأدوية والتحقق من الجرعات
  • المعدات الطبية: وضع علامات على المعدات برموز الصيانة الشريطية لإدارة الأصول
  • نتائج المختبر: إضافة الرموز الشريطية إلى مستندات نتائج الاختبار لربط بيانات المرضى بأمان

🏛️ الحكومة والامتثال

  • وثائق الهوية: إضافة الرموز الشريطية الأمنية إلى رخص القيادة والجوازات للتحقق
  • المستندات الضريبية: إنشاء رموز التتبع للنماذج الضريبية ومراقبة الامتثال
  • نماذج الامتثال: إضافة الرموز الشريطية للتتبع التنظيمي ومسارات التدقيق
  • السجلات العامة: إنشاء معرفات المستندات القابلة للبحث لقواعد البيانات الحكومية

🎓 التعليم والمكتبات

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

💼 الأعمال والمالية

  • معالجة الفواتير: إضافة الرموز الشريطية للمعالجة التلقائية للفواتير ومعالجة المدفوعات
  • إدارة المستندات: إنشاء معرفات فريدة لمستندات الأعمال والسجلات
  • تتبع الأصول: إنشاء الرموز الشريطية للمعدات والأصول في المنظمات
  • مسارات التدقيق: إضافة رموز التتبع لوثائق الامتثال والسجلات المالية