Verificado
Resolução de problemas
Textos de erro reais do início de sessão, do registo, das implementações e das chaves de API, associados ao que os resolve.
Todas as entradas abaixo citam o texto que a Xuda devolve realmente, para que o possa comparar com o que está a ver.
Iniciar sessão
| O que vê | O que significa | O que fazer |
|---|---|---|
account not found | Nenhuma conta corresponde a esse e-mail. | Verifique o e-mail, ou registe-se. |
wrong password | O e-mail existe, a palavra-passe não corresponde. | Tente de novo, ou use Esqueceu-se da palavra-passe?. |
User not found (no formulário de palavra-passe esquecida) | Nenhuma conta corresponde ao e-mail que pediu para repor. | Verifique o e-mail, ou registe-se. |
| "A sua sessão expirou. Inicie sessão novamente." | A sessão expirou, ou um operador terminou-a. HTTP 408. | Inicie sessão novamente. |
gtp_token doc not found / gtp_token expired | O token de sessão por trás de uma chamada com sessão iniciada desapareceu ou está desatualizado. | Inicie sessão novamente; o cliente normalmente redireciona-o para /dashboard/login. |
| "Demasiados registos a partir desta rede. Aguarde um pouco e tente de novo." | O limite de registos da sua rede foi atingido. Consulte Limites e quotas. | Aguarde que a janela seja reposta. |
Sem bloqueio por palavra-passe errada
A Xuda removeu o contador de tentativas falhadas e o bloqueio de conta que existiam por trás de uma palavra-passe errada. Uma palavra-passe errada é apenas uma palavra-passe errada, não há contagem decrescente de tentativas restantes nem um bloqueio temporário a aguardar.
Registar-se
| O que vê | O que significa | O que fazer |
|---|---|---|
| "A sua palavra-passe precisa dos quatro requisitos abaixo: pelo menos 8 caracteres, um número, uma letra maiúscula e um carácter especial." | A lista de verificação da palavra-passe (8 caracteres, um número, uma letra maiúscula, um carácter especial) não está totalmente cumprida. | Cumpra os quatro antes de submeter; o botão Inscrever-se fica desativado até o fazer. |
Missing email | O campo de e-mail estava vazio. | Preencha um endereço de e-mail. |
Email malformed | O e-mail falhou a validação de formato. | Indique um endereço de e-mail válido. |
| "Não foi possível criar a sua conta. Verifique os seus dados e a palavra-passe e tente de novo." | A chamada de registo voltou com um problema ao nível de um campo. | Reveja todos os campos, incluindo as regras da palavra-passe, e volte a submeter. |
| "Ocorreu um erro ao criar a sua conta. Tente de novo." | Um erro inesperado durante a criação da conta. | Tente de novo. Se continuar a acontecer, contacte o suporte. |
| "Esta app não aceita novos registos. Peça um convite ao administrador da app." | Tentou aderir a uma implementação de app cujo registo está fechado. | Peça antes um convite ao administrador da app. |
Falhas de implementação
| O que vê | O que significa | O que fazer |
|---|---|---|
vps region not found | O id da região ou do centro de dados num pedido de implementação não é resolvido. | Verifique o id da região/centro de dados para onde está a implementar. |
| "A Xuda Farm ainda não está disponível em <region>. Escolha outra região, ou escolha um centro de dados DigitalOcean em mais opções." | Escolheu a América Latina ou África. A Xuda Farm não possui locais aí. | Escolha América do Norte, Europa ou Ásia-Pacífico para um servidor Farm, ou continue com um centro de dados DigitalOcean explícito (que não está fisicamente nessa região). Consulte Região. |
| "O tipo de servidor partilhado não está disponível para um Full Stack VPS. Escolha um tipo otimizado (ou um plano maior)." | Foi escolhido o escalão de tamanho Partilhado para um Full Stack VPS, que precisa de mais do que esse escalão oferece. | Escolha um tamanho otimizado, ou um plano maior. |
| HTTP 423, Site Locked | Já está em curso uma compilação ou implementação desta app. | Aguarde que termine e depois atualize. |
| HTTP 425, Site not ready | A implementação ainda não terminou o aprovisionamento. | Aguarde e depois atualize. |
| HTTP 503, Site Off | A app está desligada, ou a conta está suspensa. | Volte a ligar a app, ou resolva a retenção da conta. |
Erros de API do tipo 401/403
| O que vê | O que significa | O que fazer |
|---|---|---|
| HTTP 401, token em falta/inválido/expirado | Sem sessão, ou um gtp_token/token de app expirado, num método que precisa de um. | Inicie sessão (painel) ou envie uma api_key válida (API). Consulte Chave de API. |
| HTTP 403, Access Denied | Autenticado, mas sem autorização: falta uma função, pertença a uma equipa ou direito do plano. | Peça acesso ao proprietário do recurso, ou verifique o seu plano. |
unauthorized api_key for <method>: <reason> | A chave que enviou não pode chamar esse método: não está na lista de permissões de uma chave personalizada, o método é private: true, ou a própria chave falhou a validação. | Verifique o modo de acesso da chave e os métodos permitidos; os métodos privados ficam fora do alcance de todas as chaves. Consulte Clearance. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: No authorization found" } } | O pedido MCP não trazia qualquer cabeçalho Authorization. | Envie a chave como Authorization: Bearer <key>. Consulte MCP. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" } } | O cabeçalho Authorization estava presente mas a chave não corresponde a um documento de chave ativo. | Verifique o valor da chave, ou crie uma nova. Consulte MCP. |
Acesso por chave
Criar uma chave de API exige primeiro a verificação de identidade, a mesma verificação de nível 2 que a Xuda pede antes de entregar um número de telefone, uma caixa de correio ou um IP portátil.
| O que vê | O que significa | O que fazer |
|---|---|---|
code: -412, error: "verification_required" | A conta não passou a verificação de identidade que as chaves de API exigem. data traz required_level, level e missing_claims. | Conclua o pedido de verificação de identidade e depois crie a chave. |
| Um método nunca aparece como acessível, mesmo numa chave de acesso total | O método tem private: true. Isto é absoluto, nenhum modo de acesso o anula. | Chame-o antes a partir de uma sessão do painel com sessão iniciada. |
| Um método que espera chamar com uma chave personalizada é recusado | O acesso personalizado é uma lista de permissões explícita; um método adicionado depois de a chave ser criada não está incluído até o marcar. | Abra a chave em Conta > Programadores > Chaves e adicione o método. |