กิจกรรมและ webhook
คุณสามารถตรวจสอบผู้ตอบแบบสอบถามที่กำลังจะสอบและเพิ่มข้อมูลเมตาเกี่ยวกับผู้ใช้รายนี้.
เมื่อคำขอผู้ตอบแบบสอบถามเริ่มสอบเซิร์ฟเวอร์ของเราจะทำการร้องขอ webhook ไปยัง URL เซิร์ฟเวอร์ของคุณเพื่อตรวจสอบว่าข้อมูลรับรองผู้ตอบแบบสอบถาม (เช่นอีเมลรหัสผ่านหรือหมายเลข Matric) จะถูกต้อง.
เซิร์ฟเวอร์ของคุณสามารถตอบสนองต่อข้อมูลเมตาบางอย่างเกี่ยวกับผู้ตอบแบบสอบถามนี้เช่น 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 ของเซิร์ฟเวอร์ได้นี่คือวิธีการ
นำทางไปยังการตั้งค่า

ไปที่ส่วนนักพัฒนา

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"
}