رمز QR عبر سطر الأوامر: ثبّت CLI الخاصة بـ sameqr واستخدمها

لماذا سطر الأوامر

CLI (Command Line Interface) هي برنامج تتحكم به بأوامر نصية في الطرفية. يمكن تكرار الأمر، وكتابته في سكربت، وربطه بأدوات أخرى، وتنفيذه بواسطة وكيل برمجة. وتجلب CLI الخاصة بـ sameqr خدمة Same-QR إلى هذا المكان بالضبط. ليس لها اعتماديات أخرى، وتحتاج فقط إلى Node.js بدءًا من الإصدار 18.

الخطوة 1: التثبيت

تأتي CLI عبر npm، مدير حزم Node.js:

npm install -g sameqr
sameqr --version

الخطوة 2: أنشئ مفتاح API

في لوحة التحكم ضمن الحساب ستجد قسم «الوصول لـ CLI والسكربتات والوكلاء». أنشئ هناك مفتاحًا. في البداية يكفي «قراءة + كتابة»: الإنشاء وتغيير الأسماء والنصوص. ومن أراد أيضًا تغيير وجهات رموز QR الموجودة أو إيقاف الصفحات أو حذفها فليختر «كامل». يبدأ المفتاح بـ sqr_live_ ويظهر مرة واحدة فقط. احفظه فورًا في مدير كلمات المرور.

الخطوة 3: تسجيل الدخول

لا يُمرَّر المفتاح أبدًا كوسيط، وإلا ظهر في سجل الصدفة. الأمر «sameqr login» يسأل عنه بشكل مخفي، ويتحقق منه، ويحفظه بحيث تقرأه أنت فقط في ~/.config/sameqr/config.json. وبدلًا من ذلك تضبط متغير البيئة SAMEQR_API_KEY، وله الأولوية دائمًا.

sameqr login
sameqr whoami

«sameqr whoami» يعرض حسابك وباقتك وكم رمز QR يمكنك أن تنشئ.

الخطوة 4: أنشئ أول رمز QR

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

مع --slug تحدد عند الإنشاء رابطًا قصيرًا خاصًا بك، ومع --label تُلحق التصنيفات. ويعرض «sameqr labels list» معرّفاتها. أما تغيير الوجهة وإيقاف الرمز وحذفه فتحتاج إلى مفتاح «كامل». عندها تسأل CLI في الطرفية، وفي السكربتات بلا طرفية لا يمرّ الأمر إلا مع --yes صريح. وعبر API يُسمح بـ 10 تغييرات كهذه كحد أقصى في الساعة و30 في اليوم.

الخطوة 5: صفحات الضيوف وقوائم الطعام

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

«seite create» يطبع عنوان الصفحة الجديدة، وفي المثال menu/gasthof-zum-loewen. وستحتاج إليه في الأوامر التالية. تُنشأ الصفحة كمسودة. و«karte import» يقرأ الصور بالذكاء الاصطناعي ويضيف المجموعات المكتشفة إلى الصفحة دون أن يستبدل شيئًا. راجع المسودة قبل أن تنشر. وللنشر يجب أن تكون بيانات المشغّل معبَّأة. الأمر الأخير ينشئ رمز QR يشير مباشرة إلى الصفحة. قوالب أخرى: preisliste وzeiten وlinks وaktion وweingut وetikett وkontakt.

الخطوة 6: في السكربتات مع --json

إذا أضفت --json إلى أمر، يأتي الرد بصيغة JSON. وتصل الأخطاء عندئذٍ بصيغة JSON أيضًا على مخرج الأخطاء، وقيمة الإرجاع تدل على نوعها: 3 تعني أنك لم تسجّل الدخول، و4 صلاحيات ناقصة، و2 إدخالًا خاطئًا. وهكذا يتفاعل السكربت بشكل محدد بدل أن يفسّر نصًا.

sameqr qr list --json

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

تجلب CLI الخاصة بـ sameqr كامل إمكانات Same-QR إلى الطرفية: رموز QR والإحصاءات وصفحات الضيوف وقوائم الطعام من الصور والتصنيفات والمشاريع. وهي خفيفة، وتتعامل مع مفتاحك بعناية، وتتحدث JSON للسكربتات ووكلاء البرمجة. وتعمل في كل باقة.

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

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