رموز QR في النشر: تحويل الوجهات تلقائيًا بعد كل إصدار

رموز QR المطبوعة والعناوين الجديدة

عند كل إصدار تنتقل صفحات: يصبح /sommerkarte هو /karte، ويصبح /produkt-a هو /produkte/a. في الموقع تعالج ذلك بإعادات التوجيه. لكن رموز QR المطبوعة تظل تشير إلى العنوان القديم، وسلاسل إعادة التوجيه تطول مع كل إصدار. أما مع رموز QR الديناميكية من Same-QR فتحوّل الوجهة مباشرة إلى العنوان الجديد.

الخطوة 1: جدول الربط في المستودع

دوّن أي رمز QR يجب أن يشير إلى أين، مثلًا في الملف qr-ziele.csv بجوار رمز QR لديك. تحصل على المعرّفات مرة واحدة بالأمر «sameqr qr list»:

speisekarte-lx3k9a1b2;https://example.com/karte
flyer-herbst-q8w7e6r5;https://example.com/aktion/herbst

الخطوة 2: مفتاح لخط النشر

في لوحة التحكم، ضمن الحساب ثم «الوصول لأداة CLI والسكربتات والوكلاء»، أنشئ مفتاحًا خاصًا من مستوى «كامل» للنشر فقط، لأن تغيير الوجهات يتطلب هذا المستوى، مع مدة صلاحية مناسبة. خزّنه كمتغير سري باسم SAMEQR_API_KEY في نظام CI لديك. تقرؤه أداة CLI من هناك دون أن تحفظه.

الخطوة 3: التحويل بعد الإصدار

بعد نجاح النشر تعمل خطوة قصيرة:

npm install -g sameqr
while IFS=";" read -r id url; do
  curl -fsS -o /dev/null "$url" || { echo "Ziel nicht erreichbar: $url"; exit 1; }
  sameqr qr update "$id" --url "$url" --yes --json || exit 1
done < qr-ziele.csv

يفحص السكربت أولًا هل يستجيب العنوان الجديد، ثم يحوّل الوجهة فقط. وعند حدوث خطأ يتوقف. ولأن أحدًا لا يجلس أمام الطرفية في CI، فإن --yes يؤكد التغيير. وتقرأ أداة CLI قبل ذلك الحالة الراهنة لكل رمز QR. مهم: عبر واجهة API يمكن تغيير 10 وجهات كحد أقصى في الساعة و30 في اليوم. لذلك تناسب هذه الخطوة حفنة من رموز QR في كل إصدار. أما التحويلات الأكبر فاستخدم لها لوحة التحكم أو الجدولة الزمنية.

الجدولة الزمنية كبديل

إذا كان الموعد معروفًا مسبقًا، كإطلاق يوم الاثنين في الساعة 9، فتتوفر الجدولة الزمنية ابتداءً من Gastro Pro أو Marketing Pro: يحوّل رمز QR إلى وجهة أخرى بدءًا من تاريخ معين أو في أوقات محددة، وفق المنطقة الزمنية لرمز QR، وبحد أقصى 10 قواعد. عندها لا تحتاج إلى أي خطوة في النشر.

الرجوع إذا حدث خطأ

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

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

مع Same-QR تصبح رموز QR المطبوعة جزءًا من نشرك: أداة CLI تناسب كل خط نشر، وحماية من الكتابة المتوازية فوق بعضها، وجدولة زمنية ابتداءً من Gastro Pro أو Marketing Pro، وفحص ليلي للوجهات كشبكة أمان. لا يقود أي رمز QR إلى صفحة فارغة بعد الإصدار.

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

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