DokumentationProdukteArtim Academy LMSCode-ReviewsCode-Reviews V1
Code-Review ändern
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Ändert Titel, Aufgabenstellung, Branches oder den Diff.
files ersetzt den Diff vollständig. Bereits eingegangene Reviews bleiben stehen — ihre Kommentare zeigen dann auf Zeilen des alten Diffs, was man vor einer Änderung wissen sollte.
PUT https://code-reviews.api.lms.artim-industries.com/v1/courses/{courseId}/code-reviews/{id}
| Methode | PUT |
| Basis | code-reviews.api.lms.artim-industries.com/v1 |
| Scope | lms.codeReviews:update |
| 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 der Review-Aufgabe. |
Anfragekörper
| Feld | Typ | Bedeutung |
|---|---|---|
title | string | Der neue Titel. |
subtitle | string | Die neue Unterzeile. |
brief | string | Die neue Aufgabenstellung. |
sourceBranch | string | Der Branch, aus dem der Diff kommt. |
baseBranch | string | Der Branch, gegen den er läuft. |
files | array | Der vollständige neue Diff. |
Felder, die der Vertrag nicht nennt, werden verworfen — ein Client kann keine eigenen Felder unterschieben.
{ "brief": "Finde die drei Fehler — einer steckt im Typ, zwei im Aufruf." }
Anfrage
curl -X PUT "https://code-reviews.api.lms.artim-industries.com/v1/courses/{courseId}/code-reviews/{id}" \
-H "Authorization: Bearer lmsapi_…" \
-H "Content-Type: application/json" \
-d '{ "brief": "Finde die drei Fehler — einer steckt im Typ, zwei im Aufruf." }'
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
id | string | Die Kennung. |
title | string | Der Titel danach. |
{ "id": "cr_2f60", "title": "Result-Typ einführen" }
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.