DokumentationProdukteArtim Academy LMSQuizzeQuizze V1
Quiz abrufen
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Ein Quiz samt Fragen und hinterlegten Lösungen.
Der Bereich ist der der Trainer, deshalb steht correctAnswer an den Fragen. Der Schüler sieht dieselben Fragen unter „Mein Lernen“ ohne dieses Feld. Die Antwortmöglichkeiten sind Zeichenketten, und die Lösung nennt sie beim Wort — bei multiple als Liste.
GET https://quizzes.api.lms.artim-industries.com/v1/courses/{courseId}/quizzes/{id}
| Methode | GET |
| Basis | quizzes.api.lms.artim-industries.com/v1 |
| Scope | lms.quizzes:read |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer lmsapi_… |
Parameter
| Parameter | Ort | Typ | Pflicht | Bedeutung |
|---|---|---|---|---|
courseId | Pfad | string | ja | Die Kennung des Kurses aus der Kursliste. |
id | Pfad | string | ja | Die Kennung des Quiz. |
Anfrage
curl "https://quizzes.api.lms.artim-industries.com/v1/courses/{courseId}/quizzes/{id}" \
-H "Authorization: Bearer lmsapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
id | string | Die Kennung. |
title | string | Der Titel. |
description | string | Die Beschreibung. |
passingScore | integer | Die Schwelle in Prozent. |
questions | array | Die Fragen als {id, type, prompt, options, correctAnswer, requiresManualReview}. |
{
"id": "qz_3311",
"title": "Typen-Quiz",
"description": null,
"passingScore": 70,
"questions": [
{
"id": "qst_01",
"type": "single",
"prompt": "Was beschreibt ein Generic?",
"options": ["Einen festen Typ", "Einen Typparameter"],
"correctAnswer": "Einen Typparameter",
"requiresManualReview": false
}
]
}
Fehler
| Status | code | Wann |
|---|---|---|
401 | invalid_token | Bearer fehlt, ist unbekannt oder abgelaufen. Verlängern über https://api.artim-industries.com/v1/oauth/token. |
403 | missing_scope | Das Token trägt den Scope dieses Endpunkts nicht. |
404 | not_found | Der Eintrag gehört nicht zum freigegebenen Akademie — oder die Anfrage kam auf der falschen Subdomain an. |
422 | invalid_request | Ein Parameter hat den falschen Typ oder liegt außerhalb des erlaubten Bereichs. |
429 | rate_limited | Kontingent erschöpft, siehe Retry-After. |
Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.
Rate Limits
Das Limit gilt pro Team, nicht pro Token.
| Zugang | Produktion | Sandbox |
|---|---|---|
| Hobby | 60 Anfragen/Minute | ohne Limit |
| Developer Mitgliedschaft | 10.000 Anfragen/Minute | ohne Limit |
Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.