กิจกรรมและ 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 ของเซิร์ฟเวอร์ได้นี่คือวิธีการ
  1. นำทางไปยังการตั้งค่า

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

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

ความคิดเห็นข้อเสนอแนะ (0)