Hướng dẫn tích hợp

Sự kiện và webhook

Xác nhận lối vào thi

Bạn có thể xác nhận một người trả lời sắp làm bài kiểm tra và cũng thêm siêu dữ liệu về người dùng này.
Khi một người trả lời yêu cầu bắt đầu kiểm tra, máy chủ của chúng tôi sẽ thực hiện yêu cầu webhook đến URL máy chủ của bạn để xác thực nếu thông tin xác thực của người trả lời (ví dụ: email, mật khẩu hoặc ma trận không) là hợp lệ.
Máy chủ của bạn có thể phản hồi tùy chọn với một số siêu dữ liệu về người trả lời này, chẳng hạn như name, email, photo, about and data.
Dưới đây ví dụ bắt chước yêu cầu được thực hiện cho máy chủ của bạn và phản hồi dự kiến nếu xác minh thành công

Xin lưu ý rằng bạn dự kiến sẽ trả lời trong vòng 60 giây hoặc yêu cầu sẽ được máy chủ của chúng tôi chấm dứt.
Nếu người trả lời không thể được máy chủ của bạn xác thực, bạn sẽ cung cấp errorMessage với lý do, nếu không bạn dự kiến sẽ bỏ qua nó.Bạn có thể tùy chọn cung cấp metadata Nếu xác nhận thành công.

Ngoài ra nếu bạn có ý định thực hiện phát hiện khuôn mặt trên người trả lời, bạn sẽ cung cấp metadata.photo với liên kết đến một hình ảnh sắc nét của người trả lời. Độ phân giải hình ảnh được đề xuất là một hình ảnh lớn hơn 1500x1500 pixel.

Đảm bảo bạn xác minh tất cả yêu cầu đến với máy chủ của bạn bằng cách kiểm tra chống lại x-client-id and x-client-secret trên tiêu đề yêu cầu

{
  "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"
}

Dưới đây ví dụ bắt chước yêu cầu được thực hiện cho máy chủ của bạn và phản hồi dự kiến nếu xác minh không thành công

{
  "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"
}

Đảm bảo bạn đã bật validate fields via webhook Trong trang sáng tạo kỳ thi

Hoặc nếu bạn đang sử dụng API nhà phát triển, hãy chắc chắn welcomePage.validate là sự thật

Đặt url webhook của bạn

Bạn có thể đặt và thay đổi URL webhook máy chủ của mình, đây là cách

Điều hướng đến cài đặt.
Chuyển đến phần Nhà phát triển.
Edit and copy your webhook url

Thừa nhận sự kiện của người trả lời

Máy chủ của chúng tôi sẽ thông báo cho máy chủ của bạn khi người trả lời đã được nhận vào một bài kiểm tra. Ví dụ dưới đây chứng minh kịch bản này

respondent_id Để tra cứu thông tin bổ sung về người trả lời này

{
  "event": "admitted_respondent",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id",
  "admittedOn": 1719221380326
}

Kết quả sự kiện sẵn sàng

Máy chủ của chúng tôi sẽ thông báo cho máy chủ của bạn khi kết quả người trả lời cho một kỳ thi đã sẵn sàng. Ví dụ dưới đây chứng minh kịch bản này

respondent_id Để tra cứu dữ liệu kết quả cho người trả lời này

{
  "event": "result_ready",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

Điều tra sự kiện hoàn chỉnh

Máy chủ của chúng tôi sẽ thông báo cho máy chủ của bạn khi điều tra về người trả lời được hoàn thành. Ví dụ dưới đây chứng minh kịch bản này

respondent_id Để tra cứu thông tin bổ sung về người trả lời này

{
  "event": "investigation_complete",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

Hướng dẫn tích hợp

Sự kiện và webhook

Xác nhận lối vào thi

Đặt url webhook của bạn

Điều hướng đến cài đặt.

Chuyển đến phần Nhà phát triển.

Edit and copy your webhook url

Thừa nhận sự kiện của người trả lời

Kết quả sự kiện sẵn sàng

Điều tra sự kiện hoàn chỉnh

Nhận xét phản hồi (0)

Liên kết chia sẻ

Hướng dẫn tích hợp