DokumentationProdukteArtim Academy LMSMein LernenMein Lernen V1
Überblick
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Konto, Akademie und die Rollen darin.
Der erste Aufruf einer Integration: er sagt, wer das Token erteilt hat und was er in dieser Akademie ist. Die Rollen entscheiden, welche weiteren Bereiche überhaupt erreichbar sind — ein Konto ohne trainer bekommt an den Kurs-Endpunkten eine 403, egal welcher Scope im Token steht.
GET https://me.api.lms.artim-industries.com/v1/
| Methode | GET |
| Basis | me.api.lms.artim-industries.com/v1 |
| Scope | lms.me:read |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer lmsapi_… |
Parameter
Dieser Endpunkt nimmt keine Parameter.
Anfrage
curl "https://me.api.lms.artim-industries.com/v1/" \
-H "Authorization: Bearer lmsapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
api | string | Die Kennung der API, hier lms-me. |
academy | string | Die Akademie, an die das Token gebunden ist. |
academyName | string | Ihr Anzeigename. |
userId | string | Die Kennung des Kontos. |
email | string | Die Adresse des Kontos. |
name | string | Vor- und Nachname, soweit hinterlegt. |
roles | array | Die Rollen in dieser Akademie: student, trainer, admin, shop_admin. |
{
"api": "lms-me",
"academy": "acd_7f31",
"academyName": "Artim Academy",
"userId": "usr_5a2c",
"email": "[email protected]",
"name": "Mia Feld",
"roles": ["student"]
}
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.