Przewodnik integracji
Wydarzenia i Webhook
Wstrzymaj wejście do egzaminu
Możesz potwierdzić respondenta, który ma zamiar przystąpić do egzaminu, a także dodać metadane o tym użytkowniku.
Gdy respondent prośby o rozpoczęcie egzaminu, nasz serwer złoży żądanie WebHook do adresu URL serwera w celu zweryfikowania, czy referencja respondenta (np. E -mail, hasło lub nie ma matrycy).
Twój serwer może opcjonalnie odpowiedzieć na niektóre metadane na temat tego respondenta, takie jak name, email, photo, about and data.
Below example mimics the request made to your server and the expected response if verification was successful
Gdy respondent prośby o rozpoczęcie egzaminu, nasz serwer złoży żądanie WebHook do adresu URL serwera w celu zweryfikowania, czy referencja respondenta (np. E -mail, hasło lub nie ma matrycy).
Twój serwer może opcjonalnie odpowiedzieć na niektóre metadane na temat tego respondenta, takie jak name, email, photo, about and data.
Below example mimics the request made to your server and the expected response if verification was successful
Należy pamiętać, że masz odpowiedzieć w ciągu 60 sekund lub żądanie zostanie zakończone przez nasz serwer.
Jeśli respondent nie może zostać zatwierdzony przez Twój serwer, oczekuje się, że zapewni się errorMessage Z tego powodu oczekuje się, że pominącie to.Możesz opcjonalnie podać metadata Jeśli walidacja zakończyła się powodzeniem.
Również jeśli zamierzasz wykryć twarz u respondenta, oczekuje się, że dostarczy metadata.photo z linkiem do ostrego obrazu respondenta. Zalecane rozdzielczość obrazu to obraz większy niż 1500 x 1500 pikseli.
Jeśli respondent nie może zostać zatwierdzony przez Twój serwer, oczekuje się, że zapewni się errorMessage Z tego powodu oczekuje się, że pominącie to.Możesz opcjonalnie podać metadata Jeśli walidacja zakończyła się powodzeniem.
Również jeśli zamierzasz wykryć twarz u respondenta, oczekuje się, że dostarczy metadata.photo z linkiem do ostrego obrazu respondenta. Zalecane rozdzielczość obrazu to obraz większy niż 1500 x 1500 pikseli.
Upewnij się, że zweryfikujesz wszystkie przychodzące żądanie do serwera, sprawdzając x-client-id and x-client-secret na nagłówku żądania
{
"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"
}Below example mimics the request made to your server and the expected response if verification failed
{
"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"
}Upewnij się, że włączyłeś validate fields via webhook Na stronie tworzenia egzaminu
Lub jeśli używasz interfejsu API programisty, upewnij się welcomePage.validate jest prawda
Lub jeśli używasz interfejsu API programisty, upewnij się welcomePage.validate jest prawda
Ustawienie adresu URL Webhook
Możesz ustawić i zmienić adres URL WebHook Server, oto jak
Przejdź do ustawień.
Przejdź do sekcji programistów.
Edit and copy your webhook url
Przyznaj respondent wydarzenia
Nasz serwer powiadomi Twój serwer, gdy pozwany został przyjęty do egzaminu. Poniżej przykład pokazuje ten scenariusz
respondent_id Aby wyszukać dodatkowe informacje o tym respondenta
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Wybór wyniku
Nasz serwer powiadomi Twój serwer, gdy wynik respondenta do egzaminu jest gotowy. Poniżej przykład pokazuje ten scenariusz
respondent_id Aby wyszukać dane wyników dla tego respondenta
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Dochodzenie Całkowite wydarzenie
Nasz serwer powiadomi Twój serwer po zakończeniu dochodzenia w sprawie respondenta. Poniżej przykład pokazuje ten scenariusz
respondent_id Aby wyszukać dodatkowe informacje o tym respondenta
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Komentarze zwrotne (0)
