Tạo kỳ thi

Để tạo một bài kiểm tra, bạn sẽ cần gửi một yêu cầu bài viết với các chi tiết kiểm tra. Dưới đây là một ví dụ:
{
  "name": "Introduction to Data Science DSC101",
  "platform": [
    "android",
    "ios",
    "web"
  ],
  "enforceDesktop": false,
  "analytics": {
    "device": true,
    "ip": true,
    "focusing": true
  },
  "openOn": 1719046628502,
  "closeOn": 1719064544928,
  "duration": 1200,
  "restricted_commands": [
    "copy",
    "cut",
    "paste",
    "right_mouse",
    "...more"
  ],
  "logo": "data:base64,WHV4MnJsN2oyZUdmb...",
  "translation": {
    "enableSelection": true,
    "entire": false,
    "langs": [
      "en",
      "zh",
      "ru",
      "de",
      "vi",
      "...more"
    ]
  },
  "redirectionLink": "https://exam.feedback.stanford.com/respondent",
  "monitoring": {
    "cam": true,
    "screen": true
  },
  "result": {
    "availability": "instant",
    "public": false,
    "viewableAns": true
  },
  "respondant": {
    "enforceUser": false,
    "multipleUserAttempts": false,
    "privateExam": false,
    "multipleInvitationAttempts": false,
    "multipleDeviceAttempt": false,
    "resumable": true,
    "charge": false
  },
  "welcomePage": {
    "content": [
      {
        "type": "text",
        "value": "Your custom html text goes here.."
      },
      {
        "type": "about",
        "value": "Enter Matric No."
      },
      {
        "type": "input",
        "value": "Enter Password"
      }
    ],
    "validate": false,
    "multipleAttempts": false
  },
  "thankYouPage": "<div>Thank you for your participation</div>",
  "courses": [
    {
      "title": "Data Wrangling and Cleaning",
      "shuffleQ": true,
      "shuffleOption": false,
      "limit": 1,
      "questions": [
        {
          "q": "Which of the following methods is used to handle missing values in a dataset?",
          "opt": [
            "Normalization",
            "One-Hot Encoding",
            "Imputation",
            "PCA (Principal Component Analysis)"
          ],
          "ans": [
            2
          ],
          "type": "radio",
          "points": 1
        },
        {
          "q": "Explain the process of data cleaning and why it is important in data science. Include examples of common issues found in raw data and how they can be addressed.",
          "type": "free",
          "points": 3
        }
      ]
    },
    {
      "title": "Statistical Analysis and Visualization",
      "shuffleQ": true,
      "shuffleOption": false,
      "questions": [
        {
          "q": "Which of the following are common types of data visualizations used in exploratory data analysis (EDA)? (Select all that apply)",
          "opt": [
            "Bar Chart",
            "Histogram",
            "Scatter Plot",
            "Decision Tree"
          ],
          "ans": [
            0,
            1,
            2
          ],
          "type": "checkbox"
        },
        {
          "q": "Which statistical measure is used to describe the spread or dispersion of a set of data points?",
          "ans": [
            "Standard Deviation",
            "S.D",
            "SD"
          ],
          "type": "exact_or"
        },
        {
          "q": "List 3 methods for measures of central tendency?",
          "ans": [
            "Mean",
            "Median",
            "Mode"
          ],
          "type": "exact_and"
        }
      ]
    }
  ]
}

Giải thích

Các trường và giá trị riêng lẻ được giải thích như sau:
Cánh đồngKiểuYêu cầuSự miêu tả
nameStringĐây sẽ là tên được đặt cho kỳ thi của bạn.
Nó không được lớn hơn 200 ký tự
platformArrayMảng này nên chứa các nền tảng bạn muốn bài kiểm tra này hỗ trợ.
Giá trị hợp lệ là android, ios web
enforceDesktopBooleanĐúng nếu bài kiểm tra này chỉ có thể được thực hiện trên các thiết bị có chiều rộng độ phân giải màn hình lớn hơn 999 pixel. Mặc định là sai
openOnNumberĐây là thời gian khi kỳ thi nên có sẵn.<br>Nó được dự kiến ​​sẽ ở định dạng thời gian kỷ nguyên, đó là số mili giây đã trôi qua kể từ nửa đêm (UTC) vào ngày 1 tháng 1 năm 1970.
closeOnNumberĐây là thời gian khi kỳ thi không còn nữa.<br>Nó được dự kiến ​​sẽ ở định dạng thời gian kỷ nguyên, đó là số mili giây đã trôi qua kể từ nửa đêm (UTC) vào ngày 1 tháng 1 năm 1970.
durationNumberĐây là giây tối đa trong đó người trả lời có thể hoàn thành kỳ thi.
logoStringĐây có thể là dữ liệu Base64 cho logo thi hoặc URL HTTPS trỏ đến một hình ảnh hợp lệ.
monitoring.camBooleanĐúng nếu bạn muốn ghi lại cam được trả lời
monitoring.screenBooleanĐúng nếu bạn muốn ghi lại màn hình người trả lời
analytics.deviceBooleanĐúng nếu bạn muốn đăng nhập thông tin thiết bị trả lời
analytics.ipBooleanĐúng nếu bạn muốn đăng nhập địa chỉ IP công khai của người trả lời
analytics.focusingBooleanĐúng nếu bạn muốn đăng nhập và gắn cờ khi người trả lời mất tập trung vào màn hình thi
restricted_commandsArrayMảng này phải chứa các lệnh sẽ bị hạn chế khi người trả lời đang làm bài kiểm tra của họ.


copy: Điều này sẽ vô hiệu hóa bất kỳ lệnh nào được liên kết với việc sao chép văn bản trên trang bài kiểm tra (e.g CTRL+C, CMD+C).
cut: Điều này sẽ vô hiệu hóa bất kỳ lệnh nào được liên kết với việc cắt văn bản trên trang thi (e.g CTRL+X, CMD+X).
paste: Điều này sẽ vô hiệu hóa bất kỳ lệnh nào được liên kết với việc dán văn bản trên trang bài kiểm tra (e.g CTRL+V, CMD+V).
right_mouse: Điều này sẽ vô hiệu hóa chuột nhấp chuột phải
print: Điều này sẽ vô hiệu hóa bất kỳ lệnh nào được liên kết với việc in trang thi (e.g CTRL+P, CMD+P).
fullscreen: Điều này sẽ vô hiệu hóa bất kỳ lệnh nào được liên kết với việc nhập toàn màn hình trên trang thi (e.g CTRL+CMD+F).
shortcut: Điều này sẽ vô hiệu hóa tất cả phím phím tắt (ví dụ: Mũi tên, Mũi tên, Arrowleft, Arrowright, N, P, 1 - 9)
sci_cal: Điều này sẽ vô hiệu hóa máy tính khoa học
basic_cal: Điều này sẽ vô hiệu hóa máy tính cơ bản
result.availabilityStringĐây có thể là bất kỳ điều nào sau đây:

instant: Nếu bạn muốn kết quả của người trả lời có sẵn ngay lập tức
manual: Nếu bạn muốn phát hành kết quả của người trả lời theo cách thủ công
off: Nếu bạn không có ý định phát hành kết quả của người trả lời trên nền tảng của chúng tôi
result.publicBooleanĐúng nếu bạn muốn tất cả người trả lời nhìn thấy điểm số của nhau
result.viewableAnsBooleanĐúng nếu bạn muốn người trả lời nhìn thấy những dấu hiệu và nỗ lực
respondant.enforceUserBooleanThực thi đăng nhập người dùng cho người trả lời.
respondant.multipleUserAttemptsBooleanKích hoạt nhiều lần thử từ cùng một người dùng. Mặc định là sai.
Xin lưu ý: Giá trị này sẽ bị bỏ qua nếu respondant.enforceUser là sai
respondant.privateExamBooleanĐúng nếu bạn muốn bài kiểm tra này chỉ được thực hiện bởi những người trả lời mà bạn đã mời.
respondant.multipleInvitationAttemptsBooleanKích hoạt nhiều lần thử từ cùng một liên kết lời mời. Mặc định là sai
Xin lưu ý: Giá trị này sẽ bị bỏ qua nếu respondant.privateExam là sai
respondant.multipleDeviceAttemptBooleanKích hoạt nhiều lần thử từ cùng một trình duyệt hoặc thiết bị. Mặc định là sai
respondant.resumableBooleanLàm cho bài kiểm tra có thể tiếp tục khi người trả lời tải lại trang. Mặc định là sai
respondant.chargeBooleanBị đơn trả lời mã thông báo cần thiết để thực hiện bài kiểm tra này. Mặc định là sai
respondant.limitNumerĐây phải là một số tổng số tích cực đại diện cho người trả lời tối đa có thể thử kỳ thi này
redirectionLinkStringCung cấp điều này sẽ chuyển hướng người dùng đến liên kết được chỉ định khi hoàn thành bài kiểm tra, với tham số truy vấn được thêm vào respondent_id=unique_id.

Ví dụ: nếu bạn cung cấp https://exam.feedback.stanford.com/respondent Là liên kết chuyển hướng của bạn, người trả lời sẽ được chuyển hướng đến https://exam.feedback.stanford.com/respondent?respondent_id=unique_id. Ở đâu unique_id sẽ là ID của người trả lời.
translation.enableSelectionBooleanĐúng nếu bạn muốn kích hoạt lựa chọn ngôn ngữ hoặc sử dụng ngôn ngữ hệ thống mặc định
translation.entireBooleanĐúng nếu bạn muốn dịch toàn bộ văn bản bài kiểm tra, bao gồm các câu hỏi và tùy chọn
translation.langsArrayMảng này phải chứa ISO 639-1 language codes trong đó bạn muốn bản dịch bài kiểm tra của bạn có sẵn.

Ngôn ngữ được hỗ trợ
  • English (en)
  • French (fr)
  • Chinese (zh)
  • German (de)
  • Swahili (sw)
  • Spanish (es)
  • Russian (ru)
  • Portuguese (pt)
  • Hindi (hi)
  • Arabic (ar)
  • Bengali (bn)
  • Japanese (ja)
  • Korean (ko)
  • Italian (it)
  • Turkish (tr)
  • Vietnamese (vi)
  • Dutch (nl)
  • Thai (th)
  • Indonesian (id)
  • Polish (pl)
  • Malay (ms)
  • Filipino (tl)
  • Swedish (sv)
  • Greek (el)
  • Czech (cs)
  • Romanian (ro)
  • Hungarian (hu)
  • Ukrainian (uk)
  • Hebrew (he)
  • Farsi (fa)
  • Danish (da)
  • Norwegian (no)
  • Finnish (fi)
  • Bulgarian (bg)
  • Albanian (sq)
  • Latvian (lv)
  • Mongolian (mn)
  • Slovak (sk)
  • Catalan (ca)
  • Georgian (ka)
  • Lithuanian (lt)
  • Serbian (sr)
welcomePage.validateBooleanĐúng nếu bạn muốn xác thực các giá trị trường của welcomePage.content thông qua url webhook của bạn. Mặc định là sai.
welcomePage.multipleAttemptsBooleanĐúng nếu bạn muốn cho phép nhiều lần thử của cùng một giá trị trường. Mặc định là sai.
welcomePage.content.typeStringKết xuất nội dung ở đầu trang chào mừng bài kiểm tra
Giá trị có thể là bất kỳ điều nào sau đây:

text: hiển thị văn bản hoặc nội dung HTML.
input: hiển thị trường đầu vào, tương ứng welcomePage.content.value sẽ được sử dụng như một trình giữ chỗ cho trường đầu vào.
thankYouPageStringNội dung văn bản hoặc HTML được hiển thị cho người trả lời sau khi họ hoàn thành hoặc gửi bài kiểm tra của họ.
courses.titleStringTiêu đề của khóa học
courses.shuffleQBooleanĐúng là xáo trộn các câu hỏi trong phần này
courses.shuffleOptionBooleanĐúng là xáo trộn các tùy chọn trong các câu hỏi với radio or checkbox
courses.limitIntegerGiá trị số nguyên hoàn toàn dương giới hạn số lượng câu hỏi tối đa mà người trả lời có thể thử trong khóa học này
courses.questions.qStringCâu hỏi cá nhân trong văn bản hoặc hình thức HTML.
courses.questions.optArrayCác tùy chọn của câu hỏi. Phải là một mảng chuỗi, có thể hỗ trợ tối đa 26 mục.
Điều này chỉ nên được cung cấp nếu courses.questions.type là một trong hai "radio" hoặc "checkbox".
courses.questions.ansArrayCâu trả lời cho câu hỏi.Nếu như courses.questions.type là một trong hai "radio" hoặc "checkbox", Đây phải là một mảng số nguyên là vị trí của các tùy chọn chính xác.Khác nếu courses.questions.type là một trong hai "exact" hoặc "exact_and", thì nó phải là một mảng chuỗi.
courses.questions.typeStringGiá trị có thể là bất kỳ điều nào sau đây:

radio: Thích hợp khi câu hỏi có các tùy chọn với một câu trả lời duy nhất.
checkbox: Thích hợp khi câu hỏi có các tùy chọn với nhiều câu trả lời.
exact: kiểm tra chống lại người trả lời cố gắng với câu trả lời đúng bằng cách sử dụng bitwise hoặc.
exact_and: kiểm tra chống lại người trả lời cố gắng với câu trả lời đúng bằng cách sử dụng bitwise và.
free: Thích hợp khi câu trả lời cho câu hỏi là một văn bản miễn phí, chẳng hạn như một bài luận hoặc giải thích. Xin lưu ý rằng câu hỏi như thế này sẽ được đánh dấu bởi động cơ AI của chúng tôi.
courses.questions.pointsNumberSố lượng điểm được gán cho câu hỏi này. Mặc định là 1
courses.questions.expStringGiải thích cho câu trả lời đúng cho câu hỏi.

Chỉnh sửa bài kiểm tra

Khi chỉnh sửa bài kiểm tra hiện có, bạn không được phép cập nhật monitoring, result respondant cánh đồng. Nhưng bạn có thể cập nhật giới hạn trong trường bị trả lời là respondant.limit.
Không có hoạt động hợp nhất được thực hiện khi cập nhật một trường chứa một đối tượng hoặc mảng làm giá trị của nó. Thay vào đó, toàn bộ giá trị của một trường như vậy được thay thế bằng cái mới.
Bạn có thể đặt một trường thành NULL nếu bạn muốn xóa nó


Để chỉnh sửa bài kiểm tra hiện có, bạn sẽ cần gửi yêu cầu đặt cùng với exest_id.
{
  "platform": [
    "web"
  ],
  "openOn": null,
  "restricted_commands": [
    "copy",
    "cut",
    "paste"
  ],
  "translation": {
    "enableSelection": true,
    "entire": true,
    "langs": [
      "en",
      "zh",
      "ru"
    ]
  },
  "questions": [
    {
      "title": "Data Wrangling and Cleaning",
      "shuffleQ": true,
      "shuffleOption": false,
      "limit": 1,
      "questions": [
        {
          "q": "Which of the following methods is used to handle missing values in a dataset?",
          "opt": [
            "Normalization",
            "One-Hot Encoding",
            "Imputation",
            "PCA (Principal Component Analysis)"
          ],
          "ans": [
            2
          ],
          "type": "radio",
          "points": 1
        },
        {
          "q": "Explain the process of data cleaning and why it is important in data science. Include examples of common issues found in raw data and how they can be addressed.",
          "type": "free",
          "points": 3
        }
      ]
    },
    {
      "title": "Statistical Analysis and Visualization",
      "shuffleQ": true,
      "shuffleOption": false,
      "questions": [
        {
          "q": "Which of the following is a Python library used for data visualization?",
          "opt": [
            "NumPy",
            "Pandas",
            "Matplotlib",
            "Scikit-learn"
          ],
          "ans": [
            2
          ],
          "type": "radio"
        },
        {
          "q": "Discuss the importance of exploratory data analysis (EDA) in data science and describe how visualization tools can be used to perform EDA.",
          "type": "free",
          "points": 2
        }
      ]
    }
  ]
}

Xóa kỳ thi

Để xóa một bài kiểm tra, bạn sẽ cần gửi một yêu cầu xóa cùng với bài kiểm tra_id.
Xóa bài kiểm tra sẽ xóa mọi dữ liệu liên quan đến bài kiểm tra đó, bao gồm tất cả dữ liệu phương tiện, câu hỏi và dữ liệu trả lời
{
  "x-client-id": "xxx-xxx-xxx",
  "x-client-secret": "xxxxxxx",
  "content-type": "application/json"
}

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