We've updated our API endpoints to match what we use in our application. Some endpoints have been deprecated. See our Deprecated Endpoints page for migration details.
يفتح رمز QR من نوع App Deep Link تطبيقك مباشرة على شاشة معيّنة — عبر مخطط URI المخصص الخاص به — إذا كان التطبيق مثبّتًا على جهاز المسح. وإن لم يكن مثبّتًا، يعود الرمز إلى صفحة تطبيقك في المتجر، أو إلى صفحة ويب عادية كحل أخير. إنه Quick Code — رمز QR ذو إجراء مباشر بدون صفحة هبوط. في التطبيق، تقرأ البطاقة الخاصة به “Open your app directly if it’s installed, otherwise fall back to the store.”
رمز App Deep Link هو دائمًا رمز ديناميكي (dynamic) — وهذا مطلوب حتى يتمكن منطق التحليل (تطبيق ← متجر ← احتياطي) من العمل وقت المسح. تحصل على عنوان URL مختصر من Scanova (scnv.io/...) ويمكنك ربط نطاق مخصص، لكن لا توجد له صفحة هبوط خاصة.
من الشريط الجانبي، انتقل إلى QR Codes، ثم انقر على Create QR Code (أو انتقل إلى /qr/create). انقر على بطاقة Quick Code.
2
اختيار App Deep Link
في شبكة أنواع Quick Code، انقر على Configure أسفل App Deep Link، في قسم Dynamic أعلى الصفحة (لا يملك هذا النوع خيار Static). سيفتح هذا النموذج على المسار /qr/quick/appDeepLink.
3
إضافة عناوين URI لتطبيقك
ضمن App URIs، أدخل واحدًا على الأقل من Android app URI أو iOS app URI — المخطط المخصص الذي يسجّله تطبيقك للفتح المباشر (مثال: myapp://profile).
4
إضافة روابط المتجر (اختياري) وعنوان احتياطي
ضمن Store links، أضف اختياريًا روابط Google Play و/أو Apple App Store الخاصة بك، وتظهر عندما لا يكون التطبيق مثبّتًا لكن نظام تشغيل الجهاز معروف. ضمن Fallback URL، أدخل Fallback web URL — هذا الحقل مطلوب، إذ يمثّل الوجهة الأخيرة لكل الحالات الأخرى.
نموذج App Deep Link Quick Code مع إدخال عناوين URI للتطبيق وروابط المتجر وعنوان احتياطي
5
النشر
انقر على Publish. تنفتح لوحة لتأكيد رمز QR أو إعادة تسميته، وتعيين مجلد أو وسوم، وضبط تصميم رمز QR قبل التأكيد.
لإنشاء رمز QR من نوع App Deep Link عبر الـ API بدلًا من الواجهة، استخدم معرّف الفئة 23 (المسمّى App Deep Link في جدول Category dropdown reference ضمن Create QR Code، حيث allowed_qr_types: "dy" — القيمة "dy" فقط صالحة لـ qr_type). بخلاف كل فئة أخرى في هذه الصفحة، حمولة info هنا هي مصفوفة صِرفة (bare array) من كتل مصنّفة بالنوع، وليست كائن {type, data}:
كل كتلة اختيارية من حيث المبدأ، لكن حقل url في كتلة fallback مطلوب فعليًا — فالنشر بدون عنوان احتياطي يفشل في التحقق بنفس الطريقة التي يمنعها بها نموذج لوحة التحكم. أدرج كتلة intentUri فقط إذا كان لديك عنوان URI واحد على الأقل للتطبيق.راجع Create QR Code للاطلاع على مخطط الطلب الكامل.