Príručka pre integráciu
Udalosti a webhook
Overenie vstupu do skúšky
Môžete overiť respondenta, ktorý sa chystá absolvovať skúšku, a tiež pridať metadáta o tomto používateľovi.
Keď žiadosť respondenta na spustenie skúšky, náš server podá žiadosť o webhook na adresu URL servera, aby overil, či je poverenie respondenta (napr. E -mail, heslo alebo matrica) platné.
Váš server môže voliteľne reagovať s niektorými metadátami o tomto respondentovi, napríklad s name, email, photo, about and data.
Nižšie napodobňuje požiadavku na váš server a očakávanú odpoveď, ak bolo overenie úspešné
Keď žiadosť respondenta na spustenie skúšky, náš server podá žiadosť o webhook na adresu URL servera, aby overil, či je poverenie respondenta (napr. E -mail, heslo alebo matrica) platné.
Váš server môže voliteľne reagovať s niektorými metadátami o tomto respondentovi, napríklad s name, email, photo, about and data.
Nižšie napodobňuje požiadavku na váš server a očakávanú odpoveď, ak bolo overenie úspešné
Upozorňujeme, že sa očakáva, že odpoviete do 60 sekúnd, alebo žiadosť ukončí náš server.
Ak by váš server nemohol respondent overiť, očakáva sa, že poskytnete errorMessage Z dôvodu, inak sa očakáva, že ho vynecháte.Môžete voliteľne poskytnúť metadata Ak bola validácia úspešná.
Tiež, ak máte v úmysle vykonávať detekciu tváre respondenta, očakáva sa, že poskytnete metadata.photo s odkazom na ostrý obraz respondenta. Odporúčané rozlíšenie obrázka je obrázok väčší ako 1500 x 1500 pixelov.
Ak by váš server nemohol respondent overiť, očakáva sa, že poskytnete errorMessage Z dôvodu, inak sa očakáva, že ho vynecháte.Môžete voliteľne poskytnúť metadata Ak bola validácia úspešná.
Tiež, ak máte v úmysle vykonávať detekciu tváre respondenta, očakáva sa, že poskytnete metadata.photo s odkazom na ostrý obraz respondenta. Odporúčané rozlíšenie obrázka je obrázok väčší ako 1500 x 1500 pixelov.
Uistite sa, že ste overili všetku prichádzajúcu žiadosť na server na serveri. x-client-id and x-client-secret na hlavičku žiadosti
{
"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"
}Nižšie napodobňuje žiadosť podaná na váš server a očakávaná odpoveď, ak overenie zlyhalo
{
"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"
}Uistite sa, že ste povolili validate fields via webhook na stránke tvorby skúšky
Alebo ak používate API pre vývojárov, uistite sa welcomePage.validate je pravda
Alebo ak používate API pre vývojárov, uistite sa welcomePage.validate je pravda
Nastavenie vašej webovej adresy URL
Môžete nastaviť a zmeniť svoju adresu URL servera webhook
Prejdite do nastavení.
Prejdite do sekcie vývojárov.
Edit and copy your webhook url
Priznaj udalosť respondenta
Náš server upozorní váš server, keď bol respondent prijatý na skúšku. Nižšie uvedený tento scenár demonštrujte tento scenár
respondent_id Ak chcete vyhľadať ďalšie informácie o tomto respondentovi
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Výsledok pripravená udalosť
Náš server upozorní váš server, keď je pripravený výsledok respondenta pre skúšku. Nižšie uvedený tento scenár demonštrujte tento scenár
respondent_id Ak chcete vyhľadať údaje o výsledkoch pre tohto respondenta
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Vyšetrovanie kompletnej udalosti
Náš server upozorní váš server po dokončení vyšetrovania respondenta. Nižšie uvedený tento scenár demonštrujte tento scenár
respondent_id Ak chcete vyhľadať ďalšie informácie o tomto respondentovi
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Spätná väzba (0)
