رموز QR في JavaScript وNode.js: حزمة npm للصور أم خدمة لرموز QR الديناميكية؟

مكتبات الصور من npm

إذا احتجت إلى رمز QR في JavaScript أو Node.js، فستجد على npm مكتبات كثيرة. تحوّل هذه المكتبات نصًا إلى صورة أو SVG، دون اتصال بالإنترنت ودون أي خدمة. وهذا مثالي للمحتوى الثابت مثل معرّفات التذاكر أو بيانات الدفع.

متى تحتاج إلى أكثر من ذلك

هذه الصورة ثابتة. إذا أردت تغيير الوجهة بعد الطباعة، أو عدّ عمليات المسح، أو معرفة متى تتعطل وجهة ما، فأنت بحاجة إلى خدمة لرموز QR الديناميكية. يحفظ Same-QR الوجهة خلف عنوان قصير ثابت، ويعدّ عمليات المسح، ويفحص كل الوجهات كل ليلة.

أداة sameqr-CLI من npm

لدى Same-QR برنامج خاص لسطر الأوامر، دون أي اعتماديات، بدءًا من Node.js 18:

npm install -g sameqr
sameqr login
sameqr qr create --name "Flyer Herbst" --url https://example.com/herbst --json

يطلب الأمر «sameqr login» مفتاح API الخاص بك مع إخفاء ما تكتبه. تنشئ المفتاح في لوحة التحكم ضمن الحساب، في «الوصول لـ CLI والسكربتات والوكلاء». وفي السكربتات تضبط SAMEQR_API_KEY بدلًا من ذلك. ومع --json يعطي كل أمر مخرجات يقرؤها سكربتك مباشرة.

واجهة REST من Node.js

للتطبيقات التي تنشئ رموز QR باستمرار، تتعامل مع الواجهة مباشرة. منذ Node.js 18 تكفي دالة fetch المدمجة:

const antwort = await fetch("https://sameqr.com/api/v1/qr", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SAMEQR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Produkt 4711", targetUrl: "https://example.com/p/4711" }),
})
const daten = await antwort.json()
if (!antwort.ok) throw new Error(daten.error.message)
console.log(daten.id)

مهم في تطبيقات الويب: يجب ألا يصل المفتاح إلى المتصفح أبدًا. مكان الطلبات الموجهة إلى الواجهة هو خادمك.

مساعدة على القرار

• المحتوى لا يتغير أبدًا ولا حاجة إلى إحصائيات: مكتبة صور من npm.
• عدد كبير من رموز QR مرة واحدة: استيراد CSV في لوحة التحكم أو سكربت قصير باستخدام sameqr-CLI.
• مهام متكررة في الطرفية أو مع Coding-Agent: sameqr-CLI مع --json.
• رموز QR تُنشأ باستمرار داخل تطبيقك: واجهة REST من الخادم.

الخلاصة: لماذا Same-QR

يناسب Same-QR أي مشروع JavaScript: أداة CLI من npm دون اعتماديات، وواجهة REST لـ fetch، وخادم MCP لوكلاء البرمجة، كل ذلك في كل باقة. بهذا تحصل على رموز QR ديناميكية مع إحصائيات، دون أن تشغّل خدمة إعادة توجيه بنفسك.

ابدأ الآن: سجّل مجانًا على sameqr.com، فـ 20 رمز QR ديناميكيًا مجانية بشكل دائم. الواجهة وCLI وخادم MCP متاحة في كل باقة، والتوثيق على sameqr.com/entwickler.

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