> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Preguntas frecuentes sobre códigos de error > Soluciona problemas con códigos de error HTTP al usar endpoints RPC de Helius. Identifica y resuelve los problemas más comunes de autenticación, límites de solicitudes y servidores ## Qué significa **401 No autorizado** - Tu solicitud no contiene credenciales de autenticación válidas. ## Causas comunes * Clave de API no válida o faltante * Clave de API incluida en la ubicación incorrecta * Reglas de control de acceso que bloquean tu solicitud * Clave de API vencida o revocada ## Soluciones 1. **Verifica el formato de tu clave de API** ``` https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY ``` 2. **Comprueba la ubicación de la clave de API** * Asegúrate de que la clave de API esté en los parámetros de consulta * Verifica que no haya espacios ni caracteres adicionales 3. **Revisa las reglas de control de acceso** * Comprueba la configuración de tu [panel](https://dashboard.helius.dev/) para ver si hay restricciones de IP * Si usas solicitudes desde el navegador, asegúrate de que tu dominio esté en la lista de permitidos Para obtener información detallada sobre la configuración de la autenticación, consulta nuestra guía de [Autenticación](/docs/es/api-reference/authentication). ## Qué significa **429 Demasiadas solicitudes** - Superaste los límites de solicitudes de tu plan. ## Causas comunes * Enviar solicitudes más rápido de lo que permite tu plan * Tráfico en ráfagas que supera los límites instantáneos * Varias aplicaciones que comparten la misma clave de API * Código ineficiente que envía solicitudes redundantes ## Soluciones 1. **Supervisa tu uso** * Consulta el gráfico `Rate Limited Requests` en tu [panel](https://dashboard.helius.dev/usage) * Revisa qué endpoints están alcanzando los límites 2. **Optimiza tus solicitudes** * Almacena las respuestas en caché cuando sea posible * Agrupa varias operaciones en una sola llamada * Elimina el sondeo innecesario o las solicitudes duplicadas 3. **Implementa límites de solicitudes** * Agrega pausas entre las solicitudes de tu aplicación * Usa retroceso exponencial para los reintentos 4. **Considera mejorar tu plan** * Consulta [Planes y límites de solicitudes](/docs/es/billing/plans) para conocer los niveles superiores Los límites de solicitudes se restablecen cada minuto, por lo que la limitación temporal suele resolverse rápidamente. ## Qué significa **500 Error interno del servidor** - Ocurrió un error del servidor mientras se procesaba tu solicitud. ## Causas comunes * Carga útil de la solicitud con formato incorrecto * Problemas temporales en el servidor * Parámetros no válidos que causan errores del servidor * Problemas de conectividad de red ## Soluciones 1. **Valida tu solicitud** * Asegúrate de que la carga útil JSON tenga el formato correcto * Verifica que estén incluidos todos los parámetros obligatorios * Comprueba que los tipos de los parámetros coincidan con la especificación de la API 2. **Comprueba el estado del servicio** * Visita la [página de estado de Helius](https://helius.statuspage.io/) para consultar los problemas en curso * Busca interrupciones reportadas o una degradación del rendimiento 3. **Implementa lógica de reintentos** * Espera unos segundos antes de volver a intentarlo * Usa retroceso exponencial para varios intentos 4. **Obtén soporte** * Si los errores persisten, contacta a soporte con los detalles de tu solicitud * Incluye la carga útil exacta de la solicitud y la marca de tiempo Los errores del servidor suelen ser temporales y normalmente se resuelven de forma automática. ## Qué significa **503 Servicio no disponible** - El servidor está temporalmente sobrecargado o en mantenimiento. ## Causas comunes * Tráfico elevado que causa una sobrecarga temporal * Periodos de mantenimiento programado * Límites de capacidad del servidor alcanzados * Problemas con la infraestructura de red ## Soluciones 1. **Espera y vuelve a intentarlo** * Espera entre 30 y 60 segundos antes de volver a intentarlo * Este error suele resolverse a medida que se equilibra la carga 2. **Implementa reintentos inteligentes** * Usa retroceso exponencial (comienza con 1 s, luego 2 s, 4 s, etc.) * Establece un límite máximo de reintentos (de 3 a 5 intentos) * Agrega una variación aleatoria para evitar efectos de avalancha 3. **Comprueba si hay mantenimiento** * Consulta la [página de estado de Helius](https://helius.statuspage.io/) para ver el mantenimiento programado * Planifica en función de los periodos de mantenimiento anunciados 4. **Distribuye la carga** * Si es posible, distribuye las solicitudes a lo largo del tiempo * Evita patrones de ráfagas que puedan activar la protección contra sobrecargas Los errores 503 están diseñados para ser temporales. El servicio se recupera automáticamente a medida que disminuye la carga del servidor. ## Qué significa **504 Tiempo de espera agotado de la puerta de enlace** - El servidor no recibió una respuesta de los servicios ascendentes dentro del periodo de espera. ## Causas comunes * Problemas de conectividad de red * Operaciones complejas que superan los límites de tiempo de espera * Respuestas lentas de la blockchain durante periodos de alta congestión de la red * Solicitudes de grandes cantidades de datos que tardan demasiado en procesarse ## Soluciones 1. **Comprueba tu conexión** * Verifica que tu conexión a Internet sea estable * Haz una prueba con una solicitud sencilla para descartar problemas locales 2. **Optimiza las solicitudes grandes** * Divide las solicitudes grandes por lotes en grupos más pequeños * Usa paginación para las consultas con grandes cantidades de datos * Considera usar conexiones WebSocket para obtener datos en tiempo real 3. **Implementa tiempos de espera** * Establece valores de tiempo de espera adecuados en el código de tu cliente (entre 30 y 60 segundos) * Gestiona correctamente los errores de tiempo de espera mediante reintentos 4. **Supervisa el estado del servicio** * Consulta la [página de estado de Helius](https://helius.statuspage.io/) para ver si hay problemas de red * Busca informes de alta congestión de la blockchain Los tiempos de espera agotados de la puerta de enlace suelen indicar congestión de la red u operaciones complejas. Considera dividir las solicitudes grandes en partes más pequeñas. ## ¿Necesitas más ayuda? Obtén ayuda de nuestro equipo mediante Discord, chat o soporte por correo electrónico. Consulta la disponibilidad del servicio y la información de rendimiento en tiempo real.