Verificada
Solución de problemas
Cadenas de error reales de inicio de sesión, registro, despliegues y claves de API, con lo que las soluciona.
Cada entrada de abajo cita la cadena que Xuda devuelve realmente, para que puedas compararla con lo que estás viendo.
Iniciar sesión
| Ves | Qué significa | Qué hacer |
|---|---|---|
account not found | Ninguna cuenta coincide con ese correo. | Revisa el correo, o regístrate. |
wrong password | El correo existe, pero la contraseña no coincide. | Inténtalo de nuevo, o usa ¿Olvidó su contraseña?. |
User not found (en el formulario de contraseña olvidada) | Ninguna cuenta coincide con el correo que pediste restablecer. | Revisa el correo, o regístrate. |
| "Tu sesión ha caducado. Inicia sesión de nuevo." | La sesión caducó por tiempo, o un operador la finalizó. HTTP 408. | Vuelve a iniciar sesión. |
gtp_token doc not found / gtp_token expired | El token de sesión que hay detrás de una llamada con sesión iniciada ya no existe o está obsoleto. | Vuelve a iniciar sesión; el cliente normalmente te redirige a /dashboard/login. |
| "Demasiados registros desde esta red. Espera un rato y vuelve a intentarlo." | Se activó el límite de registros de tu red. Consulta Límites y cuotas. | Espera a que se reinicie la ventana. |
Sin bloqueo por contraseña incorrecta
Xuda eliminó el contador de intentos fallidos y el bloqueo de cuenta que antes había tras una contraseña incorrecta. Una contraseña incorrecta es solo eso, no hay cuenta atrás de intentos restantes ni bloqueo temporal que esperar.
Registrarse
| Ves | Qué significa | Qué hacer |
|---|---|---|
| "Tu contraseña necesita los cuatro requisitos de abajo: al menos 8 caracteres, un número, una letra mayúscula y un carácter especial." | La lista de requisitos de la contraseña (8 caracteres, un número, una letra mayúscula, un carácter especial) no se cumple por completo. | Cumple los cuatro antes de enviar; el botón Registrarse permanece desactivado hasta que lo hagas. |
Missing email | El campo de correo estaba vacío. | Rellena una dirección de correo. |
Email malformed | El correo no superó la validación de formato. | Indica una dirección de correo válida. |
| "No hemos podido crear tu cuenta. Revisa tus datos y tu contraseña e inténtalo de nuevo." | La llamada de registro volvió con un problema a nivel de campo. | Revisa de nuevo todos los campos, incluidas las reglas de la contraseña, y vuelve a enviar. |
| "Algo salió mal al crear tu cuenta. Inténtalo de nuevo." | Un error inesperado durante la creación de la cuenta. | Vuelve a intentarlo. Si sigue ocurriendo, contacta con soporte. |
| "Esta app no acepta nuevos registros. Pide una invitación al administrador de la app." | Intentaste unirte a un despliegue de app cuyo registro está cerrado. | Pide una invitación al administrador de la app. |
Fallos de despliegue
| Ves | Qué significa | Qué hacer |
|---|---|---|
vps region not found | El id de región o de centro de datos de una petición de despliegue no se resuelve. | Verifica el id de la región o del centro de datos en el que vas a desplegar. |
| "xuda Farm aún no está disponible en <region>. Elige otra región, o elige un centro de datos de DigitalOcean en más opciones." | Elegiste Latinoamérica o África. Xuda Farm no tiene ubicaciones allí. | Elige Norteamérica, Europa o Asia-Pacífico para un servidor Farm, o continúa con un centro de datos de DigitalOcean explícito (que no está físicamente en esa región). Consulta Región. |
| "El tipo de servidor compartido no está disponible para un VPS full stack. Elige un tipo optimizado (o un plan más grande)." | Se eligió el nivel de tamaño Compartido para un VPS full stack, que necesita más de lo que da ese nivel. | Elige un tamaño optimizado, o un plan más grande. |
| HTTP 423, Site Locked | Ya hay en curso una compilación o un despliegue de esta app. | Espera a que termine y luego actualiza. |
| HTTP 425, Site not ready | El despliegue no ha terminado de aprovisionarse. | Espera y luego actualiza. |
| HTTP 503, Site Off | La app está apagada, o la cuenta está suspendida. | Vuelve a encender la app, o resuelve el bloqueo de la cuenta. |
Errores de tipo 401/403 de la API
| Ves | Qué significa | Qué hacer |
|---|---|---|
| HTTP 401, token ausente, no válido o caducado | No hay sesión, o hay un gtp_token o token de app caducado, en un método que lo necesita. | Inicia sesión (dashboard) o envía una api_key válida (API). Consulta Clave de API. |
| HTTP 403, Access Denied | Autenticado, pero sin autorización: falta un rol, la pertenencia a un equipo o un derecho del plan. | Solicita acceso al propietario del recurso, o revisa tu plan. |
unauthorized api_key for <method>: <reason> | La clave que enviaste no puede llamar a ese método: no está en la lista de permitidos de una clave personalizada, el método es private: true, o la propia clave no superó la validación. | Revisa el modo de acceso de la clave y los métodos permitidos; los métodos privados quedan fuera del alcance de toda clave. Consulta Clearance. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: No authorization found" } } | La petición MCP no llevaba ninguna cabecera Authorization. | Envía la clave como Authorization: Bearer <key>. Consulta MCP. |
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" } } | La cabecera Authorization estaba presente, pero la clave no corresponde a un documento de clave activo. | Revisa el valor de la clave, o crea una nueva. Consulta MCP. |
Acceso con claves
Para crear una clave de API hace falta antes verificar la identidad, la misma comprobación de nivel 2 que Xuda pide antes de entregar un número de teléfono, un buzón o una IP portátil.
| Ves | Qué significa | Qué hacer |
|---|---|---|
code: -412, error: "verification_required" | La cuenta no ha superado la verificación de identidad que exigen las claves de API. data lleva required_level, level y missing_claims. | Completa la verificación de identidad que se te pide y luego crea la clave. |
| Un método nunca aparece como accesible, ni siquiera con una clave de acceso completo | El método lleva private: true. Es absoluto, ningún modo de acceso lo anula. | Llámalo desde una sesión iniciada en el dashboard. |
| Se rechaza un método que esperabas poder llamar con una clave personalizada | El acceso personalizado es una lista de permitidos explícita; un método añadido después de crear la clave no se incluye hasta que lo marques. | Abre la clave en Cuenta > Desarrolladores > Claves y añade el método. |