통합 안내서

이벤트와 Webhook

시험 입학을 확인하십시오

시험을 치러 갈 응답자를 검증 하고이 사용자에 대한 메타 데이터를 추가 할 수 있습니다..
응답자가 시험을 시작하라는 요청이 있으면 서버가 서버 URL에 Webhook 요청을하여 응답자 자격 증명 (예 : 이메일, 암호 또는 행렬 번호)이 유효한지 확인합니다..
서버는이 응답자에 대한 일부 메타 데이터로 선택 사항에 응답 할 수 있습니다. name, email, photo, about and data.
아래 예제는 서버에 대한 요청을 모방하고 확인이 성공한 경우 예상 응답

60 초 이내에 응답해야합니다. 그렇지 않으면 요청이 서버에서 종료됩니다..
응답자가 귀하의 서버에서 검증 할 수없는 경우 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를 사용하는 경우 확인하십시오 welcomePage.validate 사실입니다

Webhook URL 설정

서버를 설정하고 변경할 수 있습니다. Webhook URL은 다음과 같습니다.

설정으로 이동하십시오.
개발자 섹션으로 이동하십시오.
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"
}

통합 안내서

이벤트와 Webhook

시험 입학을 확인하십시오

Webhook URL 설정

설정으로 이동하십시오.

개발자 섹션으로 이동하십시오.

Edit and copy your webhook url

응답자 이벤트를 인정하십시오

결과 준비 이벤트

조사 완료 이벤트

피드백 의견 (0)

공유 링크

통합 안내서