واجهة برمجة تطبيقات مولد الباركود: POST واحد، ومخرج SVG، وستة تنسيقات

يقوم تطبيق المستودع الخاص بك بطباعة ملصقات الشحن. يحتاج كل ملصق إلى رمز شريطي Code128 للتتبع رقم. يمكنك تثبيت مكتبة باركود، وعرضها على القماش، وتصديرها بتنسيق PNG، وتضمينها قالب التسمية الخاص بك. أو يمكنك إرسال مشاركة واحدة واستعادة SVG.

البوتوي /v1/barcode تقوم نقطة النهاية بتشفير البيانات إلى ستة تنسيقات للرموز الشريطية وإرجاعها سلسلة SVG داخل استجابة JSON. لا توجد حزمة npm. لا خطوة البناء. لا الاعتماد على قماش.

استدعاء API

أرسل طلب POST بالبيانات والتنسيق:

تقوم الاستجابة بتغليف SVG في مظروف JSON قياسي:

استخراج svg الحقل، قم بإسقاطه في <img> علامة، مضمّنة فيه بتنسيق HTML، أو توجيهه إلى ملف. يتم عرض SVG بوضوح بأي حجم لأنه يعتمد على المتجهات؛ لا توجد عناصر تنقيط عند 300 نقطة في البوصة أو أعلى.

حدود

تقبل نقطة النهاية خمس معلمات. فقط data مطلوب:

• بيانات (سلسلة، مطلوبة): القيمة المراد تشفيرها. بالنسبة لـ EAN-13، قم بتمرير 13 رقمًا. بالنسبة إلى Code128، قم بتمرير أي سلسلة ASCII قابلة للطباعة.
• شكل (سلسلة، افتراضية code128): أحد code128, ean-13, ean-8, upc-a, itf-14، أو msi.
• عرض (الرقم، الافتراضي 200): عرض الصورة بالبكسل. النطاق: من 50 إلى 2000.
• ارتفاع (الرقم، الافتراضي 80): ارتفاع الصورة بالبكسل. النطاق: من 20 إلى 1000.
• show_text (منطقي، افتراضي true): سواء لتقديم القيمة المشفرة كنص أسفل الأشرطة.

إليك الرمز الشريطي Code128 مع تعيين جميع المعلمات:

أمثلة عملية

إنشاء ملصق الشحن

قم بتشفير رقم التتبع كـ Code128 لقسائم التعبئة وملصقات الشحن. مقابض Code128 سلاسل أبجدية رقمية مختلطة، لذا فإن أرقام التتبع مثل "1Z999AA10123456784" تعمل بدون المعالجة المسبقة.

نظام إدارة المخزون

طباعة ملصقات Code128 لصناديق ورفوف المستودعات. يقوم الموظفون بمسحها باستخدام أجهزة القراءة المحمولة أثناء الانتقاء والتعبئة. يقوم الباركود بتشفير مسار الموقع الكامل: المستودع، الرف، سلة المهملات.

ملصقات منتجات البيع بالتجزئة (EAN-13)

EAN-13 هو المعيار الدولي لمنتجات البيع بالتجزئة. قم بتمرير رقم GTIN المكون من 13 رقمًا وواجهة برمجة التطبيقات (API). تقوم بإرجاع حجم SVG لملصقات حافة الرف القياسية.

إنشاء دفعة Node.js لكتالوج المنتجات

إنشاء رموز شريطية لكتالوج المنتجات بالكامل بالتوازي. يطلق هذا البرنامج النصي أربعة طلبات بشكل متزامن ويجمع سلاسل SVG:

الإخراج:

بالنسبة للكتالوجات التي تحتوي على مئات المنتجات، يمكنك تجميعها في مجموعات مكونة من 20 إلى 50 منتجًا للبقاء ضمن حدود الأسعار. الحد الأقصى للطبقة المجانية هو 5 طلبات في الدقيقة؛ يزيل مفتاح API هذا الحد.

مثال Node.js: ملصقات الباركود لتنفيذ الطلب

يعرض هذا الخادم السريع أ /labels/:orderId نقطة النهاية. عندما الوفاء الخاص بك تقوم طابعة النظام أو طابعة الملصقات بجلب عنوان URL هذا، وتستعيد رمز شريطي SVG لترميز الطلب رقم التتبع.

الاستخدام:

يمنع رأس ذاكرة التخزين المؤقت لمدة 24 ساعة استدعاءات API المكررة لنفس الطلب. في الإنتاج، أضف ذاكرة تخزين مؤقت CDN أو Redis أمام هذا المسار.

متى تستخدم أي تنسيق

Code128 هو الإعداد الافتراضي لسبب ما: فهو يقوم بتشفير أكبر نطاق من الأحرف ويعمل من أجله معظم الأنظمة الداخلية. قم بالتبديل إلى EAN-13 أو UPC-A عندما يحتاج منتجك إلى مسح ضوئي للبيع بالتجزئة الباركود. استخدم ITF-14 لملصقات الكرتون الخارجية في مجال الخدمات اللوجستية. MSI يناسب وضع العلامات على أرفف المستودعات حيث تحتاج إلى رموز رقمية فقط مع رقم فحص بسيط.

النقاط الرئيسية

يغطي المستوى المجاني بمعدل 5 طلبات في الدقيقة التطوير والاختبار والتسمية ذات الحجم المنخفض الطباعة. بالنسبة إلى أنظمة إنشاء الدُفعات أو أنظمة التنفيذ ذات حركة المرور العالية، قم بتمرير مفتاح واجهة برمجة التطبيقات (API) الخاص بك في ملف Authorization: Bearer header. تحقق من مستندات API للحصول على مرجع نقطة النهاية الكامل.