أنشئ رموز QR باستخدام REST API: منشور واحد وSVG فوري

يحتاج دفع التجارة الإلكترونية الخاص بك إلى عرض رمز الاستجابة السريعة لعنوان URL لتتبع كل طلب. يمكنك ذلك تثبيت مكتبة QR من جانب العميل، وتكوين عنصر قماش، والتعامل مع دورة حياة العرض، وأضف 30-40 كيلو بايت إلى الحزمة الخاصة بك. أو يمكنك إرسال طلب POST واحد واستعادة SVG.

البوتوي /v1/qr/generate تعمل نقطة النهاية على تحويل أي سلسلة أو عنوان URL إلى QR قابل للمسح الضوئي كود. يقوم بإرجاع SVG خام يمكنك تضمينه في HTML، أو حفظه في ملف، أو دفقه إلى ملف PDF. لا يوجد npm الحزمة، لا تبعية قماش، لا خطوة البناء.

استدعاء API

أرسل طلب POST بالنص الذي تريد تشفيره:

الرد عبارة عن صورة SVG خام (نوع المحتوى: image/svg+xml):

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

حدود

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

• نص (سلسلة، مطلوبة): عنوان URL أو النص المراد تشفيره. يدعم ما يصل إلى ~ 4,296 الحروف الأبجدية الرقمية.
• مقاس (الرقم، الافتراضي 300): العرض والارتفاع بالبكسل. النطاق: من 50 إلى 2000.
• darkColor (سلسلة سداسية، افتراضية #000000): اللون الأمامي لل وحدات QR.
• com.lightColor (سلسلة سداسية، افتراضية #ffffff): لون الخلفية.
• errorCorectionLevel (سلسلة، افتراضية M): واحد من L (7%)، م (15%)، س (25%)، أو ح (30%). تتحمل المستويات الأعلى المزيد من الضرر ولكنها تنتج رموزًا أكثر كثافة.
• هامِش (الرقم، الافتراضي 4): منطقة هادئة حول رمز الاستجابة السريعة في الوحدات النمطية. النطاق: من 0 إلى 20.

إليك طلبًا يستخدم جميع المعلمات الستة:

أمثلة عملية

رمز الاستجابة السريعة لقائمة المطعم

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

رمز الاستجابة السريعة لتذكرة الحدث

قم بتشفير معرف تذكرة فريد في كل رمز QR. يقوم الموظفون بمسحه ضوئيًا عند الباب باستخدام أي هاتف ذكي كاميرا. يوفر تصحيح الخطأ Q توازنًا جيدًا بين الكثافة وتحمل الضرر للشارات المطبوعة.

رابط الدفع QR Code

قم بإنشاء رابط دفع قابل للمسح الضوئي للفواتير أو الإيصالات أو شاشات نقاط البيع. ال يقوم العميل بمسحها ضوئيًا والوصول إلى صفحة الدفع الخاصة بـ Stripe.

توليد دفعة في حلقة

هل تحتاج إلى رموز QR لكتالوج المنتجات؟ قم بالمراجعة عبر قائمة عناوين URL واحفظ كل SVG على القرص. يقوم برنامج bash النصي هذا بإنشاء أربعة رموز QR في أقل من ثانية:

الإخراج:

مثال Node.js: رموز QR لتتبع الطلب

يعرض هذا الخادم السريع أ /orders/:id/qr نقطة النهاية. عندما الخروج الخاص بك يجلب قالب الصفحة أو البريد الإلكتروني التأكيدي عنوان URL هذا، ويستعيد رمز الاستجابة السريعة SVG الذي يشير إلى صفحة تتبع الطلب.

الاستخدام:

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

مكتبات QR من جانب العميل مقابل واجهة برمجة التطبيقات: متى يتم استخدامها

استخدم واجهة برمجة التطبيقات (API) عندما تحتاج إلى إنشاء من جانب الخادم (رسائل البريد الإلكتروني وملفات PDF والإيصالات)، عندما تريد ذلك احتفظ بحزمة الواجهة الأمامية الخاصة بك صغيرة، أو عندما تقوم بإنشاء رموز QR في سير عمل الواجهة الخلفية مثل معالجة الطلب أو إصدار التذاكر.

استخدم مكتبة من جانب العميل عندما يحتاج تطبيقك إلى العمل دون اتصال بالإنترنت، عندما يكون زمن الاستجابة أكثر أهمية أكبر من حجم الحزمة (العرض أقل من 5 مللي ثانية)، أو عندما تقوم بإنشاء أداة يمكن للمستخدمين إنشاءها رموز QR بشكل تفاعلي في المتصفح ولا تريد الاعتماد على طلب الشبكة لكل ضغطة مفتاح.

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

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