متى تستخدم إعادة التوجيه
- التحقق عبر الأجهزة المتعددة: ابدأ على سطح المكتب وأكمل على الجهاز المحمول
- أقصى درجات التوافق: يعمل في جميع المتصفحات، بما فيها الإصدارات القديمة
- تكامل بسيط: لا حاجة إلى إعداد iframe
- مشكلات الكاميرا: عندما يكون الوصول إلى الكاميرا داخل iframe مشكلة
التنفيذ
الخطوة 1: إنشاء جلسة (الخادم الخلفي)
تستخدم استجابة إنشاء الجلسة حقلًا اسمهurl، مرّر هذه القيمة إلى المتصفح.
الخطوة 2: توجيه المستخدم (الواجهة الأمامية)
HTML:معالجة الاستدعاء
عند اكتمال التحقق، تعيد Didit توجيه المستخدم إلى رابط الاستدعاء الخاص بك مع معاملات الاستعلام:مثال Next.js
مثال Express.js
مثال Vue Router
الفتح في تبويب جديد
إذا كنت تفضّل إبقاء تطبيقك مفتوحًا أثناء قيام المستخدم بالتحقق:أفضل ممارسات الأمان
تحقّق من رد الاستدعاء من جهة الخادم
عامل معاملي الاستعلامverificationSessionId وstatus على أنهما تلميحات واجهة غير موثوقة. أكّد القرار النهائي دائمًا على خادمك الخلفي، إما بمعالجة webhook (وهذا هو الخيار المفضّل)، أو بإعادة جلب القرار عبر واجهة API:
استخدم webhook
للحصول على أكثر تكامل موثوقية، استخدم webhook لاستلام نتائج التحقق مباشرة على خادمك الخلفي، بغض النظر عن سلوك متصفح المستخدم.تدفق التحقق عبر الأجهزة المتعددة
تدعم طريقة إعادة التوجيه التحقق عبر الأجهزة المتعددة بشكل طبيعي:- ينقر المستخدم على “تحقق” على سطح المكتب
- يُوجَّه المستخدم إلى صفحة التحقق
- إذا لزم الأمر، يمكن للمستخدم مسح رمز QR للمتابعة على الجهاز المحمول
- بعد الإكمال، يُوجَّه المستخدم إلى رابط الاستدعاء الخاص بك، ويتحكم
callback_methodفي الجهاز الذي ينفّذ إعادة التوجيه (initiatorأوcompleterأوboth)
استكشاف الأخطاء وإصلاحها
لم يتم استلام الاستدعاء
- تحقق من أن رابط الاستدعاء مضبوط بشكل صحيح عند إنشاء الجلسة
- تأكد من أن رابط الاستدعاء متاح من الإنترنت
- تحقق من أن الرابط لا يحتوي على أخطاء إملائية أو مشكلات في الترميز
الحالة دائمًا “Declined”
- تحقق من إعدادات سير العمل في Didit Console
- تأكد من أن المستندات التجريبية التي تستخدمها صالحة
- راجع تفاصيل الجلسة عبر واجهة API للاطلاع على أسباب الرفض المحددة
حلقة إعادة التوجيه
- تأكد من أن معالج الاستدعاء لا يعيد التوجيه إلى صفحة التحقق مرة أخرى
- تحقق من مشكلات التخزين المؤقت في صفحة رد الاستدعاء
- امسح ذاكرة التخزين المؤقت للمتصفح وحاول مرة أخرى
مستودع الأمثلة
مستودع GitHub
اطلع على الكود المصدري والأمثلة على GitHub