Οδηγός ολοκλήρωσης
Εκδηλώσεις και webhook
Επικυρώστε την είσοδο των εξετάσεων
Μπορείτε να επικυρώσετε έναν εναγόμενο που πρόκειται να λάβει μια εξέταση και επίσης να προσθέσει μεταδεδομένα σχετικά με αυτόν τον χρήστη.
Όταν ένα αίτημα του ερωτηθέντος να ξεκινήσει μια εξέταση, ο διακομιστής μας θα κάνει ένα αίτημα webhook στη διεύθυνση URL του διακομιστή σας για να επικυρώσει εάν το πιστοποιητικό του ερωτηθέντος (π.χ. email, κωδικός πρόσβασης ή matric no) είναι έγκυρη.
Ο διακομιστής σας μπορεί να απαντήσει με κάποια μεταδεδομένα σχετικά με αυτόν τον ερωτώμενο, όπως name, email, photo, about and data.
Παρακάτω παράδειγμα μιμείται το αίτημα που υποβάλλεται στον διακομιστή σας και την αναμενόμενη απάντηση εάν η επαλήθευση ήταν επιτυχής
Όταν ένα αίτημα του ερωτηθέντος να ξεκινήσει μια εξέταση, ο διακομιστής μας θα κάνει ένα αίτημα webhook στη διεύθυνση URL του διακομιστή σας για να επικυρώσει εάν το πιστοποιητικό του ερωτηθέντος (π.χ. email, κωδικός πρόσβασης ή matric no) είναι έγκυρη.
Ο διακομιστής σας μπορεί να απαντήσει με κάποια μεταδεδομένα σχετικά με αυτόν τον ερωτώμενο, όπως name, email, photo, about and data.
Παρακάτω παράδειγμα μιμείται το αίτημα που υποβάλλεται στον διακομιστή σας και την αναμενόμενη απάντηση εάν η επαλήθευση ήταν επιτυχής
Λάβετε υπόψη ότι αναμένεται να απαντήσετε εντός 60 δευτερολέπτων ή το αίτημα θα τερματιστεί από τον διακομιστή μας.
Εάν ο εναγόμενος δεν μπορούσε να επικυρωθεί από τον διακομιστή σας, αναμένεται να παρέχετε errorMessage Με τον λόγο, αλλιώς αναμένεται να το παραλείψετε.Μπορείτε να παράσχετε προαιρετικά το metadata Εάν η επικύρωση ήταν επιτυχής.
Επίσης, αν σκοπεύετε να εκτελέσετε ανίχνευση προσώπου στον εναγόμενο, αναμένεται να παρέχετε το metadata.photo με σύνδεσμο σε μια απότομη εικόνα του ερωτηθέντος. Η συνιστώμενη ανάλυση εικόνας είναι μια εικόνα μεγαλύτερη από 1500x1500 εικονοστοιχεία.
Εάν ο εναγόμενος δεν μπορούσε να επικυρωθεί από τον διακομιστή σας, αναμένεται να παρέχετε errorMessage Με τον λόγο, αλλιώς αναμένεται να το παραλείψετε.Μπορείτε να παράσχετε προαιρετικά το metadata Εάν η επικύρωση ήταν επιτυχής.
Επίσης, αν σκοπεύετε να εκτελέσετε ανίχνευση προσώπου στον εναγόμενο, αναμένεται να παρέχετε το metadata.photo με σύνδεσμο σε μια απότομη εικόνα του ερωτηθέντος. Η συνιστώμενη ανάλυση εικόνας είναι μια εικόνα μεγαλύτερη από 1500x1500 εικονοστοιχεία.
Βεβαιωθείτε ότι επαληθεύσατε όλα τα εισερχόμενα αίτημα σε διακομιστή σας με επιταγή x-client-id and x-client-secret στην κεφαλίδα αιτήματος
{
"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"
}Παρακάτω παράδειγμα μιμείται το αίτημα που υποβάλλεται στον διακομιστή σας και την αναμενόμενη απάντηση εάν απέτυχε η επαλήθευση
{
"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"
}Βεβαιωθείτε ότι έχετε ενεργοποιήσει validate fields via webhook στη σελίδα δημιουργίας εξετάσεων
Ή αν χρησιμοποιείτε το API Developer, βεβαιωθείτε welcomePage.validate είναι αλήθεια
Ή αν χρησιμοποιείτε το API Developer, βεβαιωθείτε welcomePage.validate είναι αλήθεια
Ρύθμιση της διεύθυνσης WebHook
Μπορείτε να ρυθμίσετε και να αλλάξετε τη διεύθυνση URL του webhook του διακομιστή σας, εδώ είναι πώς
Μεταβείτε στις ρυθμίσεις.
Μεταβείτε στο τμήμα προγραμματιστή.
Edit and copy your webhook url
Παραδοχή του ερωτηθέντος συμβάντος
Ο διακομιστής μας θα ειδοποιήσει τον διακομιστή σας όταν ένας ερωτώμενος έχει γίνει δεκτός για να λάβει μια εξέταση. Παρακάτω παράδειγμα δείξτε αυτό το σενάριο
respondent_id Για να αναζητήσετε πρόσθετες πληροφορίες σχετικά με αυτόν τον εναγόμενο
{
"event": "admitted_respondent",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id",
"admittedOn": 1719221380326
}Εκδήλωση έτοιμο αποτέλεσμα
Ο διακομιστής μας θα ειδοποιήσει τον διακομιστή σας όταν ένα αποτέλεσμα του ερωτηθέντος για μια εξέταση είναι έτοιμο. Παρακάτω παράδειγμα δείξτε αυτό το σενάριο
respondent_id Για να αναζητήσετε τα δεδομένα αποτελεσμάτων για αυτόν τον ερωτώμενο
{
"event": "result_ready",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Έρευνα πλήρους εκδήλωσης
Ο διακομιστής μας θα ειδοποιήσει τον διακομιστή σας όταν ολοκληρώνεται η έρευνα σχετικά με τον εναγόμενο. Παρακάτω παράδειγμα δείξτε αυτό το σενάριο
respondent_id Για να αναζητήσετε πρόσθετες πληροφορίες σχετικά με αυτόν τον εναγόμενο
{
"event": "investigation_complete",
"respondent_id": "some unique id given to the respondent",
"exam_id": "some unique exam_id"
}Σχόλια ανατροφοδότησης (0)
