API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · quiz_attempts

Quiz Attempt Schema

Schema-ID
quiz_attempt
Collection
quiz_attempts
Permissions
  • Lesenquiz_attempt_view
  • Anlegenquiz_attempt_create
  • Ändernquiz_attempt_edit
  • Löschenquiz_attempt_delete
Beziehungen

Felder

Quiz Attempt Schema

quiz_attempts4 Permissions

Schema for a student quiz or exam attempt

learningUnitIdstringerforderlich

ID of the quiz/exam learning unit

min 1 Zeichen
courseIdstringerforderlich

ID of the parent course (denormalized)

min 1 Zeichen
lessonIdstringerforderlich

ID of the parent lesson/section (denormalized)

min 1 Zeichen
enrollmentIdstringerforderlich

ID of the student enrollment

min 1 Zeichen
userIdstringerforderlich

ID of the student

min 1 Zeichen
attemptNumbernumbererforderlich

Sequential attempt number for this student and unit

≥ 1read-only
statusstringerforderlich

Current state of the attempt

Werte
in_progresssubmittedgradedpending_ai_reviewtimed_out
startedAtdatetimeerforderlich

When the attempt was started

submittedAtdatetimeoptional

When the attempt was submitted

nullable
timeLimitSecsnumberoptional

Time limit snapshot from unit at start of attempt

≥ 0nullable
scorenumberoptional

Raw score as percentage (0-100) after grading

0 – 100nullable
adjustedScorenumberoptional

Score after applying attempt penalty and/or late submission penalty

≥ 0nullable
isPassedbooleanoptional

Whether the attempt meets the passing score threshold

nullable
gradingMethodstringoptional

Snapshot from unit: how to calculate final grade from multiple attempts

Werte
highestaveragefirstlast
nullable
reviewOptionsobjectoptional

Snapshot of review options from unit at start of attempt

nullable
attemptPenaltyPercentnumberoptional

Snapshot from unit: percentage deducted per subsequent attempt

0 – 100nullable
lateSubmissionbooleanoptional

Whether this attempt was submitted after availableUntil

nullable
lateSubmissionPenaltynumberoptional

Late submission penalty applied (percentage)

0 – 100nullable
showCorrectAfterbooleanoptional

Snapshot from unit: whether to show correct answers after submission

nullable
allowBackNavigationbooleanoptional

Snapshot from unit: whether the student can navigate back during the attempt

nullable
answersobject[]optional

Student answers for each question

nullable
questionIdstringerforderlich
min 1 Zeichen
questionSnapshotobjecterforderlich

Full question text and options at time of attempt

answeroneOferforderlich
isCorrectbooleanoptional
nullable
pointsAwardednumberoptional
≥ 0nullable
gradedManuallybooleanoptional
nullable
instructorNotestringoptional
nullable
pendingAiGradingbooleanoptional
nullable
aiFeedbackstringoptional
nullable
aiPointsAwardednumberoptional
≥ 0nullable
aiConfidencenumberoptional
0 – 1nullable
aiGradedAtdatetimeoptional
nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/quiz_attempts — Liste, paginiert + filterbar
  • GET /api/v1/quiz_attempts/<id> — Einzelne Entity
  • POST /api/v1/quiz_attempts — Anlegen
  • PATCH /api/v1/quiz_attempts/<id> — Teil-Update
  • DELETE /api/v1/quiz_attempts/<id> — Soft-Delete
  • GET /api/v1/quiz_attempts/<id>/timeline — Audit + Aktivitäten

Suche