Tapahtumat ja webhook

Validoi kokeen pääsy

Voit vahvistaa vastaajan, joka aikoo suorittaa tentin ja lisätä myös metatietoja tästä käyttäjästä.
Kun vastaajan pyyntö aloittamaan tentti, palvelimemme pyytää Webhook -pyynnön palvelimen URL -osoitteeseen vahvistaaksesi, jos vastaaja -käyttöoikeus (esim. Sähköposti, salasana tai matric no) ovat kelvollisia.
Palvelimesi voi valinnaisesti vastata joihinkin metatietoihin tästä vastaajasta, esimerkiksi name, email, photo, about and data.
Alla oleva esimerkki jäljittelee palvelimelle esitettyä pyyntöä ja odotettua vastausta, jos varmennus onnistui
Huomaa, että sinun odotetaan vastaavan 60 sekunnin sisällä tai palvelimemme lopettaa pyynnön.
Jos palvelimesi ei voinut vahvistaa vastaajaa, sinun odotetaan tarjoavan errorMessage Syyksi, muuten sinun odotetaan jättävän sen pois.Voit valinnaisesti tarjota metadata Jos validointi onnistui.

Myös jos aiot suorittaa kasvojen havaitsemisen vastaajalle, sinun odotetaan tarjoavan metadata.photo linkillä vastaajan terävään kuvaan. Suositeltu kuvan resoluutio on yli 1500x1500 pikseliä.
Varmista, että tarkistat kaikki saapuvat pyynnöt palvelimellesi tarkistamalla x-client-id and x-client-secret pyynnön otsikossa
{
  "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"
}


Alla oleva esimerkki jäljittelee palvelimelle esitettyä pyyntöä ja odotettu vastaus, jos varmennus epäonnistui
{
  "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"
}
Varmista, että olet käytössä validate fields via webhook tentin luomissivulla


Tai jos käytät kehittäjä -sovellusliittymää, varmista welcomePage.validate on totta

Webhook -URL -osoitteen asettaminen

Voit asettaa ja muuttaa palvelimen webhook -URL -osoitetta
  1. Siirry asetuksiin.

  2. Siirry kehittäjäosaan.

  3. Edit and copy your webhook url

Myönnä vastaajatapahtuma

Palvelimemme ilmoittaa palvelimellesi, kun vastaaja on hyväksytty suorittamaan tentti. Alla oleva esimerkki osoittaa tämän skenaarion
respondent_id etsiä lisätietoja tästä vastaajasta
{
  "event": "admitted_respondent",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id",
  "admittedOn": 1719221380326
}

Tuloksena valmis

Palvelimemme ilmoittaa palvelimellesi, kun tentin vastaajatulos on valmis. Alla oleva esimerkki osoittaa tämän skenaarion
respondent_id Tämän vastaajan tulostiedot etsiä
{
  "event": "result_ready",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

Tutkinnan täydellinen tapahtuma

Palvelimemme ilmoittaa palvelimellesi, kun vastaaja on valmis. Alla oleva esimerkki osoittaa tämän skenaarion
respondent_id etsiä lisätietoja tästä vastaajasta
{
  "event": "investigation_complete",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

Palaute kommentit (0)