Skip to main content

​
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
  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 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.

​
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
    • 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
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 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 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
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?

Contact Support

Obtén ayuda de nuestro equipo mediante Discord, chat o soporte por correo electrónico.

Status Page

Consulta la disponibilidad del servicio y la información de rendimiento en tiempo real.