Gabay sa Pagsasama
Mga kaganapan at webhook
Patunayan ang pagpasok sa pagsusulit
Maaari mo bang patunayan ang isang respondente na malapit nang kumuha ng pagsusulit at magdagdag din ng metadata tungkol sa gumagamit na ito.
Kapag ang isang kahilingan ng Respondent upang magsimula ng isang pagsusulit, ang aming server ay gagawa ng isang kahilingan sa webhook sa iyong URL ng server upang mapatunayan kung ang kredensyal ng respondente (e.g email, password o matric no) ay may bisa.
Ang iyong server ay maaaring opsyonal na tumugon sa ilang metadata tungkol sa respondent na ito, tulad ng name, email, photo, about and data.
Sa ibaba halimbawa ay ginagaya ang kahilingan na ginawa sa iyong server at ang inaasahang tugon kung matagumpay ang pag -verify
Kapag ang isang kahilingan ng Respondent upang magsimula ng isang pagsusulit, ang aming server ay gagawa ng isang kahilingan sa webhook sa iyong URL ng server upang mapatunayan kung ang kredensyal ng respondente (e.g email, password o matric no) ay may bisa.
Ang iyong server ay maaaring opsyonal na tumugon sa ilang metadata tungkol sa respondent na ito, tulad ng name, email, photo, about and data.
Sa ibaba halimbawa ay ginagaya ang kahilingan na ginawa sa iyong server at ang inaasahang tugon kung matagumpay ang pag -verify
Mangyaring tandaan na inaasahan mong tumugon sa loob ng 60 segundo o ang kahilingan ay wakasan ng aming server.
Kung ang respondente ay hindi mapatunayan ng iyong server, inaasahan mong magbibigay errorMessage na may dahilan, kung hindi man ay inaasahan mong talikuran ito.Maaari mong opsyonal na magbigay ng metadata Kung ang pagpapatunay ay matagumpay.
Gayundin kung balak mong magsagawa ng pagtuklas ng mukha sa respondente, inaasahan mong ibigay ang metadata.photo na may link sa isang matalim na imahe ng respondente. Ang inirekumendang resolusyon ng imahe ay isang imahe na mas malaki kaysa sa 1500x1500 na mga piksel.
Kung ang respondente ay hindi mapatunayan ng iyong server, inaasahan mong magbibigay errorMessage na may dahilan, kung hindi man ay inaasahan mong talikuran ito.Maaari mong opsyonal na magbigay ng metadata Kung ang pagpapatunay ay matagumpay.
Gayundin kung balak mong magsagawa ng pagtuklas ng mukha sa respondente, inaasahan mong ibigay ang metadata.photo na may link sa isang matalim na imahe ng respondente. Ang inirekumendang resolusyon ng imahe ay isang imahe na mas malaki kaysa sa 1500x1500 na mga piksel.
Tiyaking i -verify mo ang lahat ng papasok na kahilingan sa iyo ng server sa pamamagitan ng tseke laban x-client-id and x-client-secret sa header ng kahilingan
{
"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"
}Sa ibaba halimbawa ay ginagaya ang kahilingan na ginawa sa iyong server at ang inaasahang tugon kung nabigo ang pag -verify
{
"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"
}Tiyaking pinagana mo validate fields via webhook sa pahina ng paglikha ng pagsusulit
O kung gumagamit ka ng developer API, tiyakin welcomePage.validate ay totoo
O kung gumagamit ka ng developer API, tiyakin welcomePage.validate ay totoo
Pagtatakda ng iyong Webhook URL
Maaari mong itakda at baguhin ang iyong Server Webhook URL, narito kung paano
Mag -navigate sa mga setting.
Pumunta sa seksyon ng developer.
Edit and copy your webhook url
Aminin ang kaganapan ng Respondent
Sasabihan ng aming server ang iyong server kapag ang isang respondente ay inamin na kumuha ng isang pagsusulit. Sa ibaba halimbawa ay nagpapakita ng sitwasyong ito
respondent_id Upang maghanap ng karagdagang impormasyon tungkol sa respondent na ito
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Resulta Handa ng Kaganapan
Sasabihan ng aming server ang iyong server kapag handa na ang isang Respondent na resulta para sa isang pagsusulit. Sa ibaba halimbawa ay nagpapakita ng sitwasyong ito
respondent_id Upang maghanap ng data ng resulta para sa respondent na ito
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Kumpletong Kaganapan sa Pagsisiyasat
Sasabihan ng aming server ang iyong server kapag nakumpleto ang pagsisiyasat sa isang respondente. Sa ibaba halimbawa ay nagpapakita ng sitwasyong ito
respondent_id Upang maghanap ng karagdagang impormasyon tungkol sa respondent na ito
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Mga Komento sa Feedback (0)
