رویدادها و وب سایت
شما می توانید یک پاسخ دهنده را که قرار است امتحان کند و همچنین ابرداده ای را در مورد این کاربر اضافه کنید ، تأیید کنید.
هنگامی که یک درخواست پاسخ دهنده برای شروع امتحان ، سرور ما درخواست Webhook را به URL سرور شما ارسال می کند تا در صورت اعتبار بودن اعتبار پاسخ دهنده (به عنوان مثال ایمیل ، رمز عبور یا عدم بلوغ) اعتبار دهد..
سرور شما می تواند با برخی از ابرداده ها در مورد این پاسخ دهنده پاسخ دهد ، مانند name, email, photo, about and data.
در زیر به عنوان مثال درخواست ارائه شده به سرور شما و پاسخ مورد انتظار در صورت موفقیت آمیز بودن را تقلید می کند
لطفاً توجه داشته باشید که انتظار می رود ظرف 60 ثانیه پاسخ دهید یا درخواست توسط سرور ما خاتمه می یابد.
اگر پاسخ دهنده نمی تواند توسط سرور شما تأیید شود ، از شما انتظار می رود ارائه دهد errorMessage با این دلیل ، در غیر این صورت از شما انتظار می رود آن را حذف کنید.شما می توانید به صورت اختیاری metadata اگر اعتبارسنجی موفقیت آمیز بود.
همچنین اگر قصد انجام تشخیص چهره را بر روی پاسخ دهنده دارید ، انتظار می رود که metadata.photo با پیوند به یک تصویر تیز از مخاطب. وضوح تصویر توصیه شده تصویری بیشتر از 1500x1500 پیکسل است.
اطمینان حاصل کنید که با بررسی در برابر سرور ، تمام درخواست های دریافتی را به سرور خود تأیید کرده اید 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 در صفحه آزمون

یا اگر از API توسعه دهنده استفاده می کنید ، مطمئن شوید
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"
}