الانتقال إلى المحتوى الرئيسي
تنقل طريقة إعادة التوجيه المستخدمين إلى صفحة تحقق تستضيفها Didit، ثم تعيدهم إلى تطبيقك عبر رابط الاستدعاء.

متى تستخدم إعادة التوجيه

  • التحقق عبر الأجهزة المتعددة: ابدأ على سطح المكتب وأكمل على الجهاز المحمول
  • أقصى درجات التوافق: يعمل في جميع المتصفحات، بما فيها الإصدارات القديمة
  • تكامل بسيط: لا حاجة إلى إعداد iframe
  • مشكلات الكاميرا: عندما يكون الوصول إلى الكاميرا داخل iframe مشكلة

التنفيذ

الخطوة 1: إنشاء جلسة (الخادم الخلفي)

تستخدم استجابة إنشاء الجلسة حقلًا اسمه url، مرّر هذه القيمة إلى المتصفح.

الخطوة 2: توجيه المستخدم (الواجهة الأمامية)

HTML:
React:
Vue:

معالجة الاستدعاء

عند اكتمال التحقق، تعيد Didit توجيه المستخدم إلى رابط الاستدعاء الخاص بك مع معاملات الاستعلام:

مثال Next.js

مثال Express.js

مثال Vue Router


الفتح في تبويب جديد

إذا كنت تفضّل إبقاء تطبيقك مفتوحًا أثناء قيام المستخدم بالتحقق:
عند استخدام تبويبات جديدة، ادمجها مع webhook لتعرف متى يكتمل التحقق.

أفضل ممارسات الأمان

تحقّق من رد الاستدعاء من جهة الخادم

عامل معاملي الاستعلام verificationSessionId وstatus على أنهما تلميحات واجهة غير موثوقة. أكّد القرار النهائي دائمًا على خادمك الخلفي، إما بمعالجة webhook (وهذا هو الخيار المفضّل)، أو بإعادة جلب القرار عبر واجهة API:

استخدم webhook

للحصول على أكثر تكامل موثوقية، استخدم webhook لاستلام نتائج التحقق مباشرة على خادمك الخلفي، بغض النظر عن سلوك متصفح المستخدم.

تدفق التحقق عبر الأجهزة المتعددة

تدعم طريقة إعادة التوجيه التحقق عبر الأجهزة المتعددة بشكل طبيعي:
  1. ينقر المستخدم على “تحقق” على سطح المكتب
  2. يُوجَّه المستخدم إلى صفحة التحقق
  3. إذا لزم الأمر، يمكن للمستخدم مسح رمز QR للمتابعة على الجهاز المحمول
  4. بعد الإكمال، يُوجَّه المستخدم إلى رابط الاستدعاء الخاص بك، ويتحكم callback_method في الجهاز الذي ينفّذ إعادة التوجيه (initiator أو completer أو both)

استكشاف الأخطاء وإصلاحها

لم يتم استلام الاستدعاء

  1. تحقق من أن رابط الاستدعاء مضبوط بشكل صحيح عند إنشاء الجلسة
  2. تأكد من أن رابط الاستدعاء متاح من الإنترنت
  3. تحقق من أن الرابط لا يحتوي على أخطاء إملائية أو مشكلات في الترميز

الحالة دائمًا “Declined”

  1. تحقق من إعدادات سير العمل في Didit Console
  2. تأكد من أن المستندات التجريبية التي تستخدمها صالحة
  3. راجع تفاصيل الجلسة عبر واجهة API للاطلاع على أسباب الرفض المحددة

حلقة إعادة التوجيه

  1. تأكد من أن معالج الاستدعاء لا يعيد التوجيه إلى صفحة التحقق مرة أخرى
  2. تحقق من مشكلات التخزين المؤقت في صفحة رد الاستدعاء
  3. امسح ذاكرة التخزين المؤقت للمتصفح وحاول مرة أخرى

مستودع الأمثلة

مستودع GitHub

اطلع على الكود المصدري والأمثلة على GitHub
آخر تعديل في ٧ نوفمبر ٢٠٢٦