دليل التكامل

الأحداث و webhook

التحقق من صحة مدخل الامتحان

يمكنك التحقق من صحة المدعى عليه على وشك إجراء اختبار وإضافة بيانات تعريف حول هذا المستخدم.
عندما يكون طلب المدعى عليه لبدء امتحان ، سيقوم الخادم الخاص بنا بتقديم طلب WebHook إلى عنوان URL الخاص بالخادم الخاص بك للتحقق من صحة ما إذا كانت بيانات اعتماد المستفتى (مثل البريد الإلكتروني أو كلمة المرور أو Matric NO) صالحة.
يمكن لخادمك الاستجابة الاختيارية مع بعض البيانات الوصفية حول هذا المدعى عليه ، مثل name, email, photo, about and data.
مثال أدناه يحاكي الطلب المقدم إلى الخادم الخاص بك والاستجابة المتوقعة إذا كان التحقق ناجحًا

يرجى ملاحظة أنه من المتوقع أن تستجيب في غضون 60 ثانية أو سيتم إنهاء الطلب بواسطة خادمنا.
إذا لم يكن من الممكن التحقق من صحة المستفتى بواسطة الخادم الخاص بك ، فمن المتوقع أن تقدم errorMessage مع السبب ، من المتوقع أن تحذفه.يمكنك توفير اختياريا metadata إذا كان التحقق من الصحة ناجحًا.

أيضًا إذا كنت تنوي أداء اكتشاف الوجه على المدعى عليه ، من المتوقع أن تقدم metadata.photo مع رابط لصورة حادة للمدعى عليه. دقة الصورة الموصى بها هي صورة أكبر من 1500 × 1500 بكسل.

تأكد من التحقق من جميع الطلبات الواردة لك الخادم عن طريق التحقق من ذلك x-client-id and x-client-secret على رأس الطلب

{
  "event": "verify_respondent",
  "fields": [
    {
      "position": 0,
      "value": "Some valid student id"
    },
    {
      "position": 1,
      "value": "Some valid student password"
    }
  ],
  "exam_id": "some unique exam_id",
  "choosenLang": "ru"
}

مثال أدناه يحاكي الطلب المقدم إلى الخادم الخاص بك والاستجابة المتوقعة إذا فشل التحقق

{
  "event": "verify_respondent",
  "fields": [
    {
      "position": 0,
      "value": "Some invalid student id"
    },
    {
      "position": 1,
      "value": "Some invalid student password"
    }
  ],
  "exam_id": "some unique exam_id..",
  "choosenLang": "ru"
}

تأكد من تمكينك validate fields via webhook في صفحة إنشاء الامتحانات

أو إذا كنت تستخدم واجهة برمجة تطبيقات المطور ، فتأكد welcomePage.validate صحيح

تعيين عنوان URL الخاص بك webhook

يمكنك ضبط وتغيير عنوان URL لـ Webhook Server الخاص بك ، إليك كيف

انتقل إلى الإعدادات.
انتقل إلى قسم المطورين.
Edit and copy your webhook url

اعترف حدث المدعى عليه

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

respondent_id للبحث عن معلومات إضافية حول هذا المدعى عليه

{
  "event": "admitted_respondent",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id",
  "admittedOn": 1719221380326
}

النتيجة حدث جاهز

سيقوم الخادم الخاص بنا بإخطار الخادم الخاص بك عندما تكون نتيجة المستجيب للامتحان جاهزة. مثال يوضح هذا السيناريو

respondent_id للبحث عن بيانات النتيجة لهذا المدعى عليه

{
  "event": "result_ready",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

التحقيق حدث كامل

سيقوم الخادم الخاص بنا بإخطار الخادم الخاص بك عند اكتمال التحقيق على المدعى عليه. مثال يوضح هذا السيناريو

respondent_id للبحث عن معلومات إضافية حول هذا المدعى عليه

{
  "event": "investigation_complete",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

دليل التكامل

الأحداث و webhook

التحقق من صحة مدخل الامتحان

تعيين عنوان URL الخاص بك webhook

انتقل إلى الإعدادات.

انتقل إلى قسم المطورين.

Edit and copy your webhook url

اعترف حدث المدعى عليه

النتيجة حدث جاهز

التحقيق حدث كامل

تعليقات التعليقات (0)

شارك الرابط

دليل التكامل