DokumentationProdukteArtim Academy LMSMein LernenMein Lernen V1
Lesson abschließen
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Markiert eine Lesson dieses Kontos als abgeschlossen.
Dasselbe, was der Haken in der Lesson tut — samt Folgewirkung: erreicht der Fortschritt die Schwelle eines Lernpfads, schalten dessen Aufgaben und Quizze frei. Zweimal aufgerufen ändert der zweite Aufruf nichts; die Antwort ist dieselbe.
POST https://me.api.lms.artim-industries.com/v1/courses/{courseId}/lessons/{lessonId}/complete
| Methode | POST |
| Basis | me.api.lms.artim-industries.com/v1 |
| Scope | lms.me.progress:write |
| 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. |
lessonId | Pfad | string | ja | Die Kennung der Lesson. |
Anfragekörper
Dieser Endpunkt braucht keinen Körper.
Anfrage
curl -X POST "https://me.api.lms.artim-industries.com/v1/courses/{courseId}/lessons/{lessonId}/complete" \
-H "Authorization: Bearer lmsapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
completed | boolean | Ob die Lesson jetzt als abgeschlossen gilt. |
percent | number | Der Fortschritt im Kurs danach. |
unlocked | array | Was dieser Abschluss freigeschaltet hat, als Kennungen. |
{ "completed": true, "percent": 50, "unlocked": ["asg_7c21"] }
Fehler
| Status | code | Wann |
|---|---|---|
400 | invalid_request | Ein Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt. |
401 | invalid_token | Bearer fehlt, ist unbekannt oder abgelaufen. |
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. |
409 | conflict | Der Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund. |
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.