Fehlerbehebung
Echte Fehlermeldungen bei Anmeldung, Registrierung, Deployments und API-Schlüsseln, jeweils mit der passenden Lösung.
Jeder Eintrag unten zitiert den String, den Xuda tatsächlich zurückgibt, damit du ihn mit dem abgleichen kannst, was du gerade vor dir siehst.
Anmelden
| Du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
account not found | Kein Konto passt zu dieser E-Mail-Adresse. | Prüfe die E-Mail-Adresse oder registriere dich stattdessen. |
wrong password | Die E-Mail-Adresse existiert, das Passwort stimmt nicht. | Versuche es erneut oder nutze Passwort vergessen?. |
User not found (im Formular "Passwort vergessen") | Kein Konto passt zu der E-Mail-Adresse, für die du ein Zurücksetzen angefordert hast. | Prüfe die E-Mail-Adresse oder registriere dich stattdessen. |
| "Deine Sitzung ist abgelaufen. Melde dich erneut an." | Die Sitzung ist abgelaufen, oder ein Operator hat sie beendet. HTTP 408. | Melde dich erneut an. |
gtp_token doc not found / gtp_token expired | Das Sitzungs-Token hinter einem angemeldeten Aufruf ist weg oder veraltet. | Melde dich erneut an. Der Client leitet normalerweise von selbst auf /dashboard/login um. |
| "Zu viele Registrierungen aus diesem Netzwerk. Bitte warte eine Weile und versuche es dann erneut." | Das Registrierungs-Ratenlimit für dein Netzwerk wurde ausgelöst. Siehe Limits und Kontingente. | Warte, bis das Zeitfenster zurückgesetzt wird. |
Xuda hat den Zähler für fehlgeschlagene Versuche und die Kontosperre entfernt, die früher hinter einem falschen Passwort standen. Ein falsches Passwort ist einfach ein falsches Passwort: Es gibt keinen Countdown der verbleibenden Versuche und keine vorübergehende Sperre, die man abwarten müsste.
Registrieren
| Du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
| "Dein Passwort braucht alle vier Punkte unten: mindestens 8 Zeichen, eine Zahl, einen Großbuchstaben und ein Sonderzeichen." | Die Passwort-Checkliste (8 Zeichen, eine Zahl, ein Großbuchstabe, ein Sonderzeichen) ist nicht vollständig erfüllt. | Erfülle alle vier Punkte vor dem Absenden. Die Schaltfläche Registrieren bleibt deaktiviert, bis du es tust. |
Missing email | Das E-Mail-Feld war leer. | Trage eine E-Mail-Adresse ein. |
Email malformed | Die E-Mail-Adresse hat die Formatprüfung nicht bestanden. | Gib eine gültige E-Mail-Adresse an. |
| "Dein Konto konnte nicht erstellt werden. Prüfe deine Angaben und dein Passwort und versuche es dann erneut." | Der Registrierungsaufruf kam mit einem Problem auf Feldebene zurück. | Prüfe jedes Feld noch einmal, auch die Passwortregeln, und sende erneut. |
| "Beim Erstellen deines Kontos ist etwas schiefgelaufen. Bitte versuche es erneut." | Ein unerwarteter Fehler bei der Kontoerstellung. | Versuche es erneut. Wenn es weiter auftritt, kontaktiere den Support. |
| "Diese App nimmt keine neuen Registrierungen an. Bitte den App-Administrator um eine Einladung." | Du hast versucht, einem App-Deployment beizutreten, dessen Registrierung geschlossen ist. | Bitte stattdessen den Administrator der App um eine Einladung. |
Deploy-Fehler
| Du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
vps region not found | Die Region- oder Rechenzentrum-ID in einer Deploy-Anfrage lässt sich nicht auflösen. | Prüfe die Region- bzw. Rechenzentrum-ID, auf die du deployst. |
| "Xuda Farm ist in <region> noch nicht verfügbar. Wähle eine andere Region oder wähle unter weitere Optionen ein DigitalOcean-Rechenzentrum." | Du hast Lateinamerika oder Afrika gewählt. Xuda Farm besitzt dort keine Standorte. | Wähle Nordamerika, Europa oder Asien-Pazifik für einen Farm-Server, oder fahre mit einem ausdrücklich gewählten DigitalOcean-Rechenzentrum fort (physisch nicht in dieser Region). Siehe Region. |
| "Der Servertyp Shared ist für einen Full Stack VPS nicht verfügbar. Wähle einen optimierten Typ (oder einen größeren Tarif)." | Die Größenstufe Shared wurde für einen Full Stack VPS gewählt, der mehr braucht, als diese Stufe bietet. | Wähle eine optimierte Größe oder einen größeren Tarif. |
| HTTP 423, Site Locked | Ein Build oder Deploy für diese App läuft bereits. | Warte, bis er fertig ist, und lade dann neu. |
| HTTP 425, Site not ready | Das Deployment ist noch nicht vollständig bereitgestellt. | Warte und lade dann neu. |
| HTTP 503, Site Off | Die App ist ausgeschaltet oder das Konto ist gesperrt. | Schalte die App wieder ein oder löse die Kontosperre auf. |
API-Fehler im Stil von 401/403
| Du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
| HTTP 401, missing/invalid/expired token | Keine Sitzung oder ein abgelaufenes gtp_token/App-Token bei einer Methode, die eines braucht. | Melde dich an (Dashboard) oder sende einen gültigen api_key (API). Siehe API-Schlüssel. |
| HTTP 403, Access Denied | Angemeldet, aber nicht berechtigt: eine fehlende Rolle, Teammitgliedschaft oder Tarifberechtigung. | Bitte den Eigentümer der Ressource um Zugriff oder prüfe deinen Tarif. |
unauthorized api_key for <method>: <reason> | Der gesendete Schlüssel darf diese Methode nicht aufrufen: Sie steht nicht auf der Positivliste eines benutzerdefinierten Schlüssels, die Methode ist private: true, oder der Schlüssel selbst hat die Validierung nicht bestanden. | Prüfe den Zugriffsmodus und die erlaubten Methoden des Schlüssels. Private Methoden bleiben für jeden Schlüssel unerreichbar. Siehe Clearance. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: No authorization found" } } | Die MCP-Anfrage enthielt überhaupt keinen Authorization-Header. | Sende den Schlüssel als Authorization: Bearer <key>. Siehe MCP. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" } } | Der Authorization-Header war vorhanden, aber der Schlüssel führt nicht zu einem aktiven Schlüsseldokument. | Prüfe den Schlüsselwert oder erstelle einen neuen. Siehe MCP. |
Schlüsselzugriff
Zum Erstellen eines API-Schlüssels ist zuerst eine Identitätsprüfung nötig, dieselbe Level-2-Prüfung, die Xuda verlangt, bevor es eine Telefonnummer, ein Postfach oder eine portable IP herausgibt.
| Du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
code: -412, error: "verification_required" | Das Konto hat die Identitätsprüfung, die API-Schlüssel verlangen, nicht bestanden. data enthält required_level, level und missing_claims. | Schließe die Aufforderung zur Identitätsprüfung ab und erstelle dann den Schlüssel. |
| Eine Methode erscheint nie als erreichbar, selbst mit einem Schlüssel mit vollem Zugriff | Die Methode trägt private: true. Das gilt absolut, kein Zugriffsmodus hebt es auf. | Rufe sie stattdessen aus einer angemeldeten Dashboard-Sitzung auf. |
| Eine Methode, die du mit einem benutzerdefinierten Schlüssel aufrufen willst, wird abgelehnt | Benutzerdefinierter Zugriff ist eine ausdrückliche Positivliste. Eine Methode, die nach dem Erstellen des Schlüssels hinzukam, ist erst enthalten, wenn du sie ankreuzt. | Öffne den Schlüssel unter Konto > Entwickler > Schlüssel und füge die Methode hinzu. |