Panduan Integrasi
Acara dan Webhook
Mengesahkan pintu masuk peperiksaan
Anda boleh mengesahkan responden yang akan mengambil peperiksaan dan juga menambah metadata mengenai pengguna ini.
Apabila permintaan responden memulakan peperiksaan, pelayan kami akan membuat permintaan webhook ke URL pelayan anda untuk mengesahkan jika kelayakan responden (misalnya e -mel, kata laluan atau matrik tidak) sah.
Pelayan anda boleh bertindak balas dengan beberapa metadata mengenai responden ini, seperti name, email, photo, about and data.
Di bawah contoh meniru permintaan yang dibuat ke pelayan anda dan tindak balas yang diharapkan jika pengesahan berjaya
Apabila permintaan responden memulakan peperiksaan, pelayan kami akan membuat permintaan webhook ke URL pelayan anda untuk mengesahkan jika kelayakan responden (misalnya e -mel, kata laluan atau matrik tidak) sah.
Pelayan anda boleh bertindak balas dengan beberapa metadata mengenai responden ini, seperti name, email, photo, about and data.
Di bawah contoh meniru permintaan yang dibuat ke pelayan anda dan tindak balas yang diharapkan jika pengesahan berjaya
Sila ambil perhatian bahawa anda dijangka bertindak balas dalam masa 60 saat atau permintaan akan ditamatkan oleh pelayan kami.
Sekiranya responden tidak dapat disahkan oleh pelayan anda, anda dijangka menyediakan errorMessage Dengan alasannya, jika tidak, anda dijangka menghilangkannya.Anda boleh memberikan pilihan metadata Sekiranya pengesahan berjaya.
Juga jika anda berhasrat untuk melakukan pengesanan muka pada responden, anda dijangka memberikan metadata.photo dengan pautan ke imej tajam responden. Resolusi imej yang disyorkan adalah imej yang lebih besar daripada 1500x1500 piksel.
Sekiranya responden tidak dapat disahkan oleh pelayan anda, anda dijangka menyediakan errorMessage Dengan alasannya, jika tidak, anda dijangka menghilangkannya.Anda boleh memberikan pilihan metadata Sekiranya pengesahan berjaya.
Juga jika anda berhasrat untuk melakukan pengesanan muka pada responden, anda dijangka memberikan metadata.photo dengan pautan ke imej tajam responden. Resolusi imej yang disyorkan adalah imej yang lebih besar daripada 1500x1500 piksel.
Pastikan anda mengesahkan semua permintaan masuk ke pelayan anda dengan periksa x-client-id and x-client-secret atas tajuk permintaan
{
"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"
}Contoh di bawah meniru permintaan yang dibuat ke pelayan anda dan tindak balas yang diharapkan jika pengesahan gagal
{
"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"
}Pastikan anda diaktifkan validate fields via webhook di halaman penciptaan peperiksaan
Atau jika anda menggunakan API pemaju, pastikan welcomePage.validate benar
Atau jika anda menggunakan API pemaju, pastikan welcomePage.validate benar
Menetapkan URL Webhook Anda
Anda boleh menetapkan dan menukar URL webhook pelayan anda, inilah caranya
Navigasi ke tetapan.
Pergi ke bahagian pemaju.
Edit and copy your webhook url
Mengakui peristiwa responden
Pelayan kami akan memberitahu pelayan anda apabila responden telah dimasukkan untuk mengambil peperiksaan. Contoh di bawah menunjukkan senario ini
respondent_id untuk mencari maklumat tambahan mengenai responden ini
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Acara Sedia Hasil
Pelayan kami akan memaklumkan pelayan anda apabila responden menghasilkan peperiksaan siap. Contoh di bawah menunjukkan senario ini
respondent_id untuk mencari data hasil untuk responden ini
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Acara Lengkap Penyiasatan
Pelayan kami akan memaklumkan pelayan anda apabila siasatan pada responden selesai. Contoh di bawah menunjukkan senario ini
respondent_id untuk mencari maklumat tambahan mengenai responden ini
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Komen maklum balas (0)
