Verificata
Risoluzione dei problemi
Stringhe di errore reali di accesso, registrazione, deploy e chiavi API, abbinate a ciò che le risolve.
Ogni voce qui sotto riporta la stringa che Xuda restituisce davvero, così puoi confrontarla con ciò che stai vedendo.
Accesso
| Cosa vedi | Cosa significa | Cosa fare |
|---|---|---|
account not found | Nessun account corrisponde a quell'email. | Controlla l'email, oppure registrati. |
wrong password | L'email esiste, la password non corrisponde. | Riprova, oppure usa Hai dimenticato la password?. |
User not found (nel modulo di password dimenticata) | Nessun account corrisponde all'email di cui hai chiesto il ripristino. | Controlla l'email, oppure registrati. |
| "La tua sessione è scaduta. Accedi di nuovo." | La sessione è scaduta, oppure un operatore l'ha terminata. HTTP 408. | Accedi di nuovo. |
gtp_token doc not found / gtp_token expired | Il token di sessione dietro una chiamata con accesso effettuato non c'è più o è obsoleto. | Accedi di nuovo; di norma il client ti reindirizza da solo a /dashboard/login. |
| "Too many sign ups from this network. Please wait a while and try again." | È scattato il limite di registrazioni per la tua rete. Vedi Limiti e quote. | Attendi che la finestra si azzeri. |
Nessun blocco dopo una password sbagliata
Xuda ha rimosso il contatore dei tentativi falliti e il blocco dell'account che prima stavano dietro una password sbagliata. Una password sbagliata è solo una password sbagliata: non c'è un conto alla rovescia dei tentativi rimasti né un blocco temporaneo da aspettare.
Registrazione
| Cosa vedi | Cosa significa | Cosa fare |
|---|---|---|
| "La password deve soddisfare tutti e quattro i requisiti: almeno 8 caratteri, un numero, una lettera maiuscola e un carattere speciale." | L'elenco dei requisiti della password (8 caratteri, un numero, una lettera maiuscola, un carattere speciale) non è soddisfatto del tutto. | Soddisfa tutti e quattro i requisiti prima di inviare; il pulsante Registrati resta disattivato finché non lo fai. |
Missing email | Il campo email era vuoto. | Inserisci un indirizzo email. |
Email malformed | L'email non ha superato il controllo del formato. | Inserisci un indirizzo email valido. |
| "Non è stato possibile creare il tuo account. Controlla i tuoi dati e la password, poi riprova." | La chiamata di registrazione è tornata con un problema a livello di campo. | Ricontrolla ogni campo, comprese le regole della password, e invia di nuovo. |
| "Qualcosa è andato storto nella creazione del tuo account. Riprova." | Un errore imprevisto durante la creazione dell'account. | Riprova. Se continua a succedere, contatta l'assistenza. |
| "Questa app non accetta nuove registrazioni. Chiedi un invito all'amministratore dell'app." | Hai provato a unirti a un deployment di app con la registrazione chiusa. | Chiedi invece un invito all'amministratore dell'app. |
Errori di deploy
| Cosa vedi | Cosa significa | Cosa fare |
|---|---|---|
vps region not found | L'id della regione o del datacenter in una richiesta di deploy non viene risolto. | Verifica l'id della regione o del datacenter su cui stai facendo il deploy. |
| "xuda Farm non è ancora disponibile in <region>. Scegli un'altra regione, oppure scegli un datacenter DigitalOcean in altre opzioni." | Hai scelto America Latina o Africa. Xuda Farm non ha sedi lì. | Scegli Nord America, Europa o Asia-Pacifico per un server Farm, oppure continua con un datacenter DigitalOcean esplicito (non fisicamente in quella regione). Vedi Regione. |
| "Il tipo di server condiviso non è disponibile per un Full Stack VPS. Scegli un tipo ottimizzato (o un piano più grande)." | Per un Full Stack VPS è stato scelto il livello di dimensione Condiviso, ma serve più di quanto quel livello offre. | Scegli una dimensione ottimizzata, oppure un piano più grande. |
| HTTP 423, Site Locked | Una build o un deploy per questa app è già in corso. | Attendi che finisca, poi aggiorna. |
| HTTP 425, Site not ready | Il deployment non ha ancora finito il provisioning. | Attendi, poi aggiorna. |
| HTTP 503, Site Off | L'app è spenta, oppure l'account è sospeso. | Riaccendi l'app, oppure risolvi il blocco dell'account. |
Errori API di tipo 401/403
| Cosa vedi | Cosa significa | Cosa fare |
|---|---|---|
| HTTP 401, token mancante, non valido o scaduto | Nessuna sessione, oppure un gtp_token o token dell'app scaduto, su un metodo che ne richiede uno. | Accedi (dashboard) oppure invia una api_key valida (API). Vedi Chiave API. |
| HTTP 403, Access Denied | Autenticato, ma non autorizzato: manca un ruolo, l'appartenenza a un team o un diritto del piano. | Chiedi l'accesso al proprietario della risorsa, oppure controlla il tuo piano. |
unauthorized api_key for <method>: <reason> | La chiave che hai inviato non può chiamare quel metodo: non è nella lista dei metodi consentiti di una chiave personalizzata, il metodo è private: true, oppure la chiave stessa non ha superato la validazione. | Controlla la modalità di accesso e i metodi consentiti della chiave; i metodi privati restano fuori dalla portata di ogni chiave. Vedi Clearance. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: No authorization found" } } | La richiesta MCP non portava alcun header Authorization. | Invia la chiave come Authorization: Bearer <key>. Vedi MCP. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" } } | L'header Authorization c'era, ma la chiave non corrisponde a un documento di chiave attivo. | Controlla il valore della chiave, oppure creane una nuova. Vedi MCP. |
Accesso con le chiavi
Per creare una chiave API serve prima la verifica dell'identità, lo stesso controllo di livello 2 che Xuda chiede prima di assegnare un numero di telefono, una casella di posta o un IP portatile.
| Cosa vedi | Cosa significa | Cosa fare |
|---|---|---|
code: -412, error: "verification_required" | L'account non ha superato il controllo di identità richiesto per le chiavi API. data contiene required_level, level e missing_claims. | Completa la richiesta di verifica dell'identità, poi crea la chiave. |
| Un metodo non risulta mai raggiungibile nemmeno con una chiave ad accesso completo | Il metodo ha private: true. È assoluto, nessuna modalità di accesso lo scavalca. | Chiamalo invece da una sessione della dashboard con accesso effettuato. |
| Un metodo che ti aspetti di chiamare con una chiave personalizzata viene rifiutato | L'accesso personalizzato è una lista esplicita di metodi consentiti; un metodo aggiunto dopo la creazione della chiave non è incluso finché non lo selezioni. | Apri la chiave in Account > Sviluppatori > Chiavi API e aggiungi il metodo. |