Entegrasyon kılavuzu
Etkinlikler ve Webhook
Sınav girişini doğrulayın
Sınav almak üzere olan bir katılımcıyı doğrulayabilir ve bu kullanıcı hakkında meta veriler ekleyebilirsiniz..
Yanıtlayan bir sınav başlatma talebinde bulunduğunda, sunucumuz, yanıtlayan kimlik bilgilerinin (örneğin e -posta, şifre veya matrik no) geçerli olup olmadığını doğrulamak için sunucu URL'nize bir WebHook isteği yapacaktır..
Sunucunuz, bu katılımcı hakkında bazı meta verilerle isteğe bağlı yanıt verebilir, örneğin name, email, photo, about and data.
Aşağıdaki örnek, sunucunuza yapılan isteği ve doğrulama başarılı olursa beklenen yanıtı taklit eder
Yanıtlayan bir sınav başlatma talebinde bulunduğunda, sunucumuz, yanıtlayan kimlik bilgilerinin (örneğin e -posta, şifre veya matrik no) geçerli olup olmadığını doğrulamak için sunucu URL'nize bir WebHook isteği yapacaktır..
Sunucunuz, bu katılımcı hakkında bazı meta verilerle isteğe bağlı yanıt verebilir, örneğin name, email, photo, about and data.
Aşağıdaki örnek, sunucunuza yapılan isteği ve doğrulama başarılı olursa beklenen yanıtı taklit eder
Lütfen 60 saniye içinde yanıt vermeniz beklendiğini veya talebin sunucumuz tarafından feshedileceğini lütfen unutmayın..
Katılımcı sunucunuz tarafından doğrulanamazsa, errorMessage Sebebiyle, başka atlamanız bekleniyor.İsteğe bağlı olarak şunları sağlayabilirsiniz. metadata Doğrulama başarılı olsaydı.
Ayrıca, yanıtlayanda yüz tespiti gerçekleştirmeyi planlıyorsanız, metadata.photo yanıtlayanın keskin bir görüntüsüne bağlantı ile. Önerilen görüntü çözünürlüğü 1500x1500 pikselden büyük bir görüntüdür.
Katılımcı sunucunuz tarafından doğrulanamazsa, errorMessage Sebebiyle, başka atlamanız bekleniyor.İsteğe bağlı olarak şunları sağlayabilirsiniz. metadata Doğrulama başarılı olsaydı.
Ayrıca, yanıtlayanda yüz tespiti gerçekleştirmeyi planlıyorsanız, metadata.photo yanıtlayanın keskin bir görüntüsüne bağlantı ile. Önerilen görüntü çözünürlüğü 1500x1500 pikselden büyük bir görüntüdür.
Sunucunuza gelen tüm isteği kontrol ederek doğruladığınızdan emin olun x-client-id and x-client-secret İstek başlığı üzerine
{
"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"
}Aşağıdaki örnek, sunucunuza yapılan isteği ve doğrulama başarısız olursa beklenen yanıtı taklit eder
{
"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"
}Etkinleştirdiğinizden emin olun validate fields via webhook Sınav oluşturma sayfasında
Veya geliştirici API'sını kullanıyorsanız, welcomePage.validate doğrudur
Veya geliştirici API'sını kullanıyorsanız, welcomePage.validate doğrudur
Webhook URL'nizi ayarlamak
Sunucunuzu WebHook URL'sini ayarlayabilir ve değiştirebilirsiniz, işte nasıl
Ayarlara gidin.
Geliştirici bölümüne gidin.
Edit and copy your webhook url
Yanıtlayan etkinliği kabul et
Bir yanıtlayıcının sınava girmesi kabul edildiğinde sunucumuz sunucunuzu bilgilendirecektir. Aşağıdaki örnek bu senaryoyu gösterir
respondent_id Bu katılımcı hakkında ek bilgi aramak için
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Sonuç Hazır Etkinliği
Bir sınav için yanıt veren bir sonuç hazır olduğunda sunucumuz sunucunuzu bilgilendirecektir. Aşağıdaki örnek bu senaryoyu gösterir
respondent_id Bu katılımcı için sonuç verilerini aramak için
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Araştırma Komple Etkinliği
Bir yanıtlayan soruşturma tamamlandığında sunucumuz sunucunuzu bilgilendirecektir. Aşağıdaki örnek bu senaryoyu gösterir
respondent_id Bu katılımcı hakkında ek bilgi aramak için
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Geri Bildirim Yorumları (0)
