Panduan Integrasi
Acara dan Webhook
Validasi pintu masuk ujian
Anda dapat memvalidasi responden yang akan mengikuti ujian dan juga menambahkan metadata tentang pengguna ini.
Ketika permintaan responden untuk memulai ujian, server kami akan membuat permintaan webhook ke URL server Anda untuk memvalidasi jika kredensial responden (mis. Email, kata sandi atau matrik) valid.
Server Anda dapat merespons opsional dengan beberapa metadata tentang responden ini, seperti name, email, photo, about and data.
Contoh di bawah ini meniru permintaan yang dibuat ke server Anda dan respons yang diharapkan jika verifikasi berhasil
Ketika permintaan responden untuk memulai ujian, server kami akan membuat permintaan webhook ke URL server Anda untuk memvalidasi jika kredensial responden (mis. Email, kata sandi atau matrik) valid.
Server Anda dapat merespons opsional dengan beberapa metadata tentang responden ini, seperti name, email, photo, about and data.
Contoh di bawah ini meniru permintaan yang dibuat ke server Anda dan respons yang diharapkan jika verifikasi berhasil
Harap dicatat bahwa Anda diharapkan merespons dalam 60 detik atau permintaan akan diakhiri oleh server kami.
Jika responden tidak dapat divalidasi oleh server Anda, Anda diharapkan menyediakan errorMessage dengan alasannya, kalau tidak, Anda diharapkan untuk menghilangkannya.Anda secara opsional dapat menyediakan metadata Jika validasi berhasil.
Juga jika Anda bermaksud melakukan deteksi wajah pada responden, Anda diharapkan memberikan metadata.photo dengan tautan ke gambar yang tajam dari responden. Resolusi gambar yang disarankan adalah gambar yang lebih besar dari 1500x1500 piksel.
Jika responden tidak dapat divalidasi oleh server Anda, Anda diharapkan menyediakan errorMessage dengan alasannya, kalau tidak, Anda diharapkan untuk menghilangkannya.Anda secara opsional dapat menyediakan metadata Jika validasi berhasil.
Juga jika Anda bermaksud melakukan deteksi wajah pada responden, Anda diharapkan memberikan metadata.photo dengan tautan ke gambar yang tajam dari responden. Resolusi gambar yang disarankan adalah gambar yang lebih besar dari 1500x1500 piksel.
Pastikan Anda memverifikasi semua permintaan yang masuk ke server Anda dengan memeriksa x-client-id and x-client-secret di header 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 ini meniru permintaan yang dibuat ke server Anda dan respons yang diharapkan jika verifikasi 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 pembuatan ujian
Atau jika Anda menggunakan API pengembang, pastikan welcomePage.validate benar
Atau jika Anda menggunakan API pengembang, pastikan welcomePage.validate benar
Mengatur url webhook Anda
Anda dapat mengatur dan mengubah URL webhook server Anda, begitulah caranya
Arahkan ke Pengaturan.
Pergi ke bagian pengembang.
Edit and copy your webhook url
Mengakui acara responden
Server kami akan memberi tahu server Anda ketika responden telah dirawat untuk mengikuti ujian. Contoh di bawah ini menunjukkan skenario ini
respondent_id untuk mencari informasi tambahan tentang responden ini
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Acara siap hasil
Server kami akan memberi tahu server Anda ketika hasil responden untuk ujian sudah siap. Contoh di bawah ini menunjukkan skenario 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"
}Investigasi acara lengkap
Server kami akan memberi tahu server Anda ketika investigasi pada responden selesai. Contoh di bawah ini menunjukkan skenario ini
respondent_id untuk mencari informasi tambahan tentang responden ini
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Komentar Umpan Balik (0)
