--- title: "Fehler verstehen | StudioMeyer Academy" description: "Stabile Fehlercodes, verständliche Hinweise und sichere nächste Schritte." canonical: "https://studiomeyer.academy/entwickler/fehler" language: de markdown_versions: ["https://studiomeyer.academy/entwickler/fehler.md", "https://studiomeyer.academy/en/entwickler/fehler.md", "https://studiomeyer.academy/es/entwickler/fehler.md"] publisher: "StudioMeyer Academy, https://studiomeyer.academy (llms.txt: https://studiomeyer.academy/llms.txt)" --- ## Auf Codes reagieren Verzweige auf slug oder code, niemals auf message. Jeder Fehler trägt message, hint und documentation\_url. request\_id steht im Body und als X-Request-Id im Header. Nenne diese Kennung bei einer Fehlermeldung, ohne Tokens oder persönliche Inhalte mitzuschicken. - [GET /v1/errors](https://studiomeyer.academy/v1/errors) - [OpenAPI](https://studiomeyer.academy/v1/openapi.json) ## Sicher erneut versuchen Bei rate\_limited warte Retry-After ab. Bei insufficient\_scope neu verbinden lassen. Bei price\_changed eine neue Quote und Zustimmung einholen. Bei outcome\_unknown zuerst Buchungen und Ergebnis lesen; kein neuer Key für denselben unsicheren Bezahlvorgang. OAuth-Fehler verwenden error und error\_description statt des Academy-Umschlags. ## Referenz ### `auth_required` Fehler 1000 · HTTP 401 Anmeldung erforderlich. **Nächster Schritt:** Melde Dich per OAuth an oder nutze den freien Eingang. ### `invalid_token` Fehler 1001 · HTTP 401 Der Zugang ist ungültig oder abgelaufen. **Nächster Schritt:** Erneuere den Zugang oder verbinde Dich erneut. ### `insufficient_scope` Fehler 1002 · HTTP 403 Eine erforderliche Berechtigung fehlt. **Nächster Schritt:** Verbinde Dich erneut und wähle die erforderlichen Berechtigungen. ### `credits_spend_not_granted` Fehler 1003 · HTTP 403 Credits ausgeben ist nicht erlaubt. **Nächster Schritt:** Frage den Menschen nach seiner Zustimmung und verbinde Dich erneut. ### `account_suspended` Fehler 1004 · HTTP 403 Das Konto ist gesperrt. **Nächster Schritt:** Wende Dich an den Support. ### `session_required` Fehler 1005 · HTTP 403 Dieser Vorgang braucht eine Browser-Sitzung. **Nächster Schritt:** Öffne den Kontolink im Browser. ### `validation_failed` Fehler 1100 · HTTP 400 Die Eingabe ist ungültig. **Nächster Schritt:** Korrigiere die Felder anhand des veröffentlichten Schemas. ### `not_found` Fehler 1101 · HTTP 404 Der Eintrag wurde nicht gefunden. **Nächster Schritt:** Suche über /v1/search. ### `idempotency_key_reused` Fehler 1102 · HTTP 409 Der Vorgangsschlüssel gehört zu einer anderen Anfrage. **Nächster Schritt:** Verwende für einen neuen Vorgang einen neuen Schlüssel. ### `conflict` Fehler 1103 · HTTP 409 Die Anfrage widerspricht dem aktuellen Stand. **Nächster Schritt:** Lies den aktuellen Stand und versuche es erneut. ### `idempotency_key_required` Fehler 1104 · HTTP 400 Der Vorgangsschlüssel fehlt. **Nächster Schritt:** Sende den Header Idempotency-Key mit. ### `idempotency_in_flight` Fehler 1105 · HTTP 409 Dieser Vorgang läuft bereits. **Nächster Schritt:** Lies den Stand, bevor Du erneut sendest. ### `confirmation_required` Fehler 1106 · HTTP 422 Die ausdrückliche Zustimmung fehlt. **Nächster Schritt:** Zeige den Vorgang und sende ihn erst nach Zustimmung mit der Bestätigung. ### `locale_not_supported` Fehler 1107 · HTTP 400 Diese Sprache wird nicht unterstützt. **Nächster Schritt:** Wähle de, en oder es. ### `rate_limited` Fehler 1200 · HTTP 429 Das Abruflimit ist erreicht. **Nächster Schritt:** Warte die in Retry-After genannten Sekunden. ### `tutor_limit_reached` Fehler 1201 · HTTP 409 Das Tutor-Limit ist erreicht. **Nächster Schritt:** Versuche es später erneut. ### `path_not_found` Fehler 2001 · HTTP 404 Der Lernweg wurde nicht gefunden. **Nächster Schritt:** Lies die verfügbaren Lernwege unter /v1/paths. ### `module_not_found` Fehler 2002 · HTTP 404 Das Modul wurde nicht gefunden. **Nächster Schritt:** Lies den Lernweg und seine bestätigten Inhalte. ### `lesson_not_found` Fehler 2003 · HTTP 404 Die Lektion wurde nicht gefunden. **Nächster Schritt:** Prüfe Level und Slug oder nutze die Suche. ### `library_item_not_found` Fehler 2004 · HTTP 404 Der Bibliothekseintrag wurde nicht gefunden. **Nächster Schritt:** Lies die Bibliothek unter /v1/library. ### `content_type_unknown` Fehler 2005 · HTTP 400 Der Inhaltstyp ist unbekannt. **Nächster Schritt:** Wähle einen im Schema genannten Inhaltstyp. ### `premium_required` Fehler 2006 · HTTP 402 Dieser Inhalt braucht eine Premium-Freischaltung. **Nächster Schritt:** Lies die Vorschau und frage vor der Freischaltung nach Zustimmung. ### `content_dormant` Fehler 2007 · HTTP 410 Dieser Inhalt ist nicht mehr aktiv. **Nächster Schritt:** Prüfe den angegebenen Nachfolger. ### `lesson_already_completed` Fehler 3001 · HTTP 409 Die Lektion ist bereits erledigt. **Nächster Schritt:** Lerne über /v1/me/continue weiter. ### `quiz_not_available` Fehler 3002 · HTTP 404 Zu dieser Lektion gibt es kein Quiz. **Nächster Schritt:** Wiederhole die Lektion. ### `note_not_found` Fehler 3003 · HTTP 404 Die Notiz wurde nicht gefunden. **Nächster Schritt:** Lies Deine Notizen unter /v1/me/notes. ### `insufficient_credits` Fehler 4002 · HTTP 409 Die Credits reichen nicht aus. **Nächster Schritt:** Vergleiche Preis und Guthaben auf der Kontoseite. ### `bonus_credits_not_allowed` Fehler 4003 · HTTP 422 Bonus-Credits gelten nicht für Coaching. **Nächster Schritt:** Nutze zulässige Credits oder frage ohne Zahlung an. ### `already_unlocked` Fehler 4004 · HTTP 409 Der Inhalt ist bereits freigeschaltet. **Nächster Schritt:** Lies ihn unter /v1/me/premium/{id}. ### `price_changed` Fehler 4005 · HTTP 409 Der Preis hat sich geändert. **Nächster Schritt:** Zeige die neue Vorschau und frage erneut nach Zustimmung. ### `outcome_unknown` Fehler 4006 · HTTP 503 Das Ergebnis des Vorgangs ist unklar. **Nächster Schritt:** Prüfe zuerst /v1/me/credits/ledger und sende nicht doppelt. ### `package_not_found` Fehler 5001 · HTTP 404 Das Paket wurde nicht gefunden. **Nächster Schritt:** Suche im Katalog nach einem verfügbaren Paket. ### `draft_consent_required` Fehler 5002 · HTTP 422 Das Paket ist ein Entwurf. **Nächster Schritt:** Frage nach Zustimmung und sende dann consentDraft: true. ### `package_deprecated` Fehler 5003 · HTTP 410 Das Paket ist abgekündigt. **Nächster Schritt:** Prüfe den Nachfolger in den Links. ### `lockfile_invalid` Fehler 5004 · HTTP 400 Die Lockdatei ist ungültig. **Nächster Schritt:** Prüfe die Lockdatei anhand des Paketformats. ### `local_changes_detected` Fehler 5005 · HTTP 409 Lokale Änderungen wurden erkannt. **Nächster Schritt:** Zeige die Änderungen und kläre sie vor einem Update. ### `script_consent_required` Fehler 5006 · HTTP 422 Das Paket enthält Skripte. **Nächster Schritt:** Zeige die Skripte und frage gesondert nach Zustimmung. ### `internal` Fehler 9000 · HTTP 500 Ein Serverfehler ist aufgetreten. **Nächster Schritt:** Melde den Fehler mit der Anfrage-ID. ### `not_implemented` Fehler 9001 · HTTP 501 Diese Funktion ist noch nicht verfügbar. **Nächster Schritt:** Prüfe das Änderungsprotokoll. ### `temporarily_unavailable` Fehler 9002 · HTTP 503 Der Vorgang ist derzeit nicht verfügbar. **Nächster Schritt:** Prüfe die genannten Voraussetzungen und versuche es später erneut. ## Sitemap Öffentliche Seiten dieser Website als Markdown: [Sitemap](https://studiomeyer.academy/sitemap.md). Kuratierter Einstieg: [llms.txt](https://studiomeyer.academy/llms.txt), Volltext: [llms-full.txt](https://studiomeyer.academy/llms-full.txt).