Zweryfikowano
Rozwiązywanie problemów
Prawdziwe komunikaty błędów z logowania, rejestracji, wdrożeń i kluczy API, dopasowane do tego, co je naprawia.
Każdy wpis poniżej cytuje ciąg, który Xuda faktycznie zwraca (w oryginale, po angielsku), żebyś mógł go dopasować do tego, na co patrzysz.
Logowanie
| Co widzisz | Co to oznacza | Co zrobić |
|---|---|---|
account not found | Żadne konto nie pasuje do tego e-maila. | Sprawdź e-mail albo zarejestruj się. |
wrong password | E-mail istnieje, hasło się nie zgadza. | Spróbuj ponownie albo użyj Nie pamiętasz hasła?. |
User not found (w formularzu zapomnianego hasła) | Żadne konto nie pasuje do e-maila, dla którego prosisz o reset. | Sprawdź e-mail albo zarejestruj się. |
| "Your session expired. Sign in again." | Sesja wygasła albo zakończył ją operator. HTTP 408. | Zaloguj się ponownie. |
gtp_token doc not found / gtp_token expired | Token sesji stojący za wywołaniem zalogowanego użytkownika zniknął albo jest nieaktualny. | Zaloguj się ponownie; klient zwykle sam przekierowuje do /dashboard/login. |
| "Too many sign ups from this network. Please wait a while and try again." | Limit rejestracji dla Twojej sieci został przekroczony. Zobacz Limity i przydziały. | Poczekaj, aż okno się zresetuje. |
Brak blokady po błędnym haśle
Xuda usunęła licznik nieudanych prób i blokadę konta, które kiedyś stały za błędnym hasłem. Błędne hasło to po prostu błędne hasło, nie ma odliczania pozostałych prób ani czasowej blokady, którą trzeba przeczekać.
Rejestracja
| Co widzisz | Co to oznacza | Co zrobić |
|---|---|---|
| "Your password needs all four below, at least 8 characters, a number, an uppercase letter, and a special character." | Lista wymagań hasła (8 znaków, cyfra, wielka litera, znak specjalny) nie jest w pełni spełniona. | Spełnij wszystkie cztery przed wysłaniem; przycisk Zarejestruj się pozostaje wyłączony, dopóki tego nie zrobisz. |
Missing email | Pole e-mail było puste. | Wpisz adres e-mail. |
Email malformed | E-mail nie przeszedł walidacji formatu. | Podaj prawidłowy adres e-mail. |
| "We couldn't create your account. Please check your details and password, then try again." | Wywołanie rejestracji wróciło z problemem na poziomie pola. | Sprawdź jeszcze raz każde pole, w tym zasady hasła, i wyślij ponownie. |
| "Something went wrong creating your account. Please try again." | Nieoczekiwany błąd podczas tworzenia konta. | Spróbuj ponownie. Jeśli się powtarza, skontaktuj się z pomocą techniczną. |
| "This app does not accept new sign ups. Ask the app administrator for an invitation." | Próbowałeś dołączyć do wdrożenia aplikacji, w którym rejestracja jest zamknięta. | Poproś administratora aplikacji o zaproszenie. |
Błędy wdrożenia
| Co widzisz | Co to oznacza | Co zrobić |
|---|---|---|
vps region not found | Identyfikator regionu lub datacenter w żądaniu wdrożenia nie jest rozpoznawany. | Zweryfikuj identyfikator regionu/datacenter, na który wdrażasz. |
| "xuda Farm is not available in <region> yet. Pick another region, or choose a DigitalOcean datacenter under more options." | Wybrałeś Amerykę Łacińską lub Afrykę. Xuda Farm nie ma tam żadnych lokalizacji. | Wybierz Amerykę Północną, Europę lub Azję i Pacyfik dla serwera Farm albo kontynuuj z jawnie wskazanym datacenter DigitalOcean (fizycznie nie w tym regionie). Zobacz Region. |
| "The shared server type is not available for a Full Stack VPS. Choose an optimized type (or a larger plan)." | Dla Pełnostosowego VPS wybrano poziom rozmiaru Shared, a ten potrzebuje więcej, niż daje ten poziom. | Wybierz zoptymalizowany rozmiar albo większy plan. |
| HTTP 423, Site Locked | Budowanie lub wdrożenie tej aplikacji już trwa. | Poczekaj na zakończenie, potem odśwież. |
| HTTP 425, Site not ready | Wdrożenie nie skończyło przygotowywania. | Poczekaj, potem odśwież. |
| HTTP 503, Site Off | Aplikacja jest wyłączona albo konto jest zawieszone. | Włącz aplikację z powrotem albo rozwiąż blokadę konta. |
Błędy API w stylu 401/403
| Co widzisz | Co to oznacza | Co zrobić |
|---|---|---|
| HTTP 401, brakujący/nieprawidłowy/wygasły token | Brak sesji albo wygasły gtp_token/token aplikacji przy metodzie, która go wymaga. | Zaloguj się (pulpit) albo wyślij prawidłowy api_key (API). Zobacz Klucz API. |
| HTTP 403, Access Denied | Uwierzytelniono, ale brak uprawnień: brakująca rola, członkostwo w zespole lub uprawnienie planu. | Poproś właściciela zasobu o dostęp albo sprawdź swój plan. |
unauthorized api_key for <method>: <reason> | Klucz, który wysłałeś, nie może wywołać tej metody: nie ma jej na liście dozwolonych klucza niestandardowego, metoda ma private: true albo sam klucz nie przeszedł walidacji. | Sprawdź tryb dostępu klucza i dozwolone metody; metody prywatne pozostają poza zasięgiem każdego klucza. Zobacz Clearance. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: No authorization found" } } | Żądanie MCP nie niosło żadnego nagłówka Authorization. | Wyślij klucz jako Authorization: Bearer <key>. Zobacz MCP. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" } } | Nagłówek Authorization był obecny, ale klucz nie odpowiada żadnemu aktywnemu dokumentowi klucza. | Sprawdź wartość klucza albo wygeneruj nowy. Zobacz MCP. |
Dostęp do kluczy
Utworzenie klucza API wymaga najpierw weryfikacji tożsamości, tego samego sprawdzenia poziomu 2, o które Xuda prosi przed wydaniem numeru telefonu, skrzynki pocztowej czy przenośnego IP.
| Co widzisz | Co to oznacza | Co zrobić |
|---|---|---|
code: -412, error: "verification_required" | Konto nie przeszło kontroli tożsamości, której wymagają klucze API. data niesie required_level, level i missing_claims. | Dokończ monit weryfikacji tożsamości, potem utwórz klucz. |
| Metoda nigdy nie pojawia się jako osiągalna, nawet dla klucza z pełnym dostępem | Metoda ma private: true. To jest bezwzględne, żaden tryb dostępu tego nie zmienia. | Wywołaj ją zamiast tego z zalogowanej sesji pulpitu. |
| Metoda, którą spodziewasz się wywołać kluczem niestandardowym, jest odrzucana | Dostęp niestandardowy to jawna lista dozwolonych; metoda dodana po utworzeniu klucza nie jest uwzględniona, dopóki jej nie zaznaczysz. | Otwórz klucz w Konto > Programiści > Klucze i dodaj metodę. |