auto-post.io

Español

English
Français

Español

English
Français

Códigos de error ​

Referencia completa de los códigos de error de auto-post.io y sus soluciones.

Formato del código de error ​

Estructura del código ​

  • Categoría: Tipo de error (API, AUTH, CONTENT, etc.)
  • Severidad: Impacto del error (FATAL, ERROR, WARN, INFO)
  • Código específico: Identificador único del error
  • Mensaje humano: Descripción amigable para el usuario

Ejemplo de formato ​

AUTH_001: Autenticación fallida - Clave API inválida
CONTENT_003: Generación de contenido fallida - Créditos insuficientes
API_005: Límite de tasa excedido - Demasiadas solicitudes

Errores de autenticación (AUTH_xxx) ​

AUTH_001: Clave API inválida ​

Descripción: La clave API proporcionada es inválida o ha expirado Causas:

  • Clave API incorrecta
  • Clave expirada
  • Acceso revocado Solución:
  • Verificar la clave API en el panel
  • Generar nueva clave si es necesario
  • Comprobar permisos de la clave

AUTH_002: Permisos insuficientes ​

Descripción: El usuario no tiene los permisos necesarios para esta acción Causas:

  • Restricciones de acceso basadas en roles
  • Limitaciones de funciones
  • Suspensión de cuenta Solución:
  • Comprobar rol y permisos del usuario
  • Contactar al administrador para acceso
  • Actualizar plan si es necesario

AUTH_003: Autenticación de dos factores requerida ​

Descripción: La cuenta requiere verificación 2FA Causas:

  • Requisitos de política de seguridad
  • Actividad sospechosa detectada
  • Inicio de sesión desde dispositivo nuevo Solución:
  • Completar verificación 2FA
  • Usar dispositivo de confianza
  • Contactar soporte si los problemas persisten

AUTH_004: Cuenta bloqueada ​

Descripción: Cuenta bloqueada temporalmente por motivos de seguridad Causas:

  • Múltiples intentos de inicio de sesión fallidos
  • Actividad sospechosa
  • Violaciones de política Solución:
  • Esperar desbloqueo automático (normalmente 30 minutos)
  • Contactar soporte para asistencia inmediata
  • Revisar prácticas de seguridad

AUTH_005: Sesión expirada ​

Descripción: La sesión del usuario ha expirado Causas:

  • Timeout por inactividad
  • Política de seguridad
  • Reinicio del servidor Solución:
  • Iniciar sesión de nuevo
  • Comprobar configuración de timeout de sesión
  • Activar opción "recordarme"

Errores de generación de contenido (CONTENT_xxx) ​

CONTENT_001: Modelo IA no disponible ​

Descripción: El modelo IA seleccionado no está disponible actualmente Causas:

  • Interrupción del servicio
  • Mantenimiento del modelo
  • Alta demanda Solución:
  • Probar modelo IA alternativo
  • Comprobar página de estado del servicio
  • Reintentar después de unos minutos

CONTENT_002: Timeout de generación de contenido ​

Descripción: La generación de contenido tardó demasiado Causas:

  • Requisitos de contenido complejos
  • Alta carga del servidor
  • Problemas de red Solución:
  • Simplificar requisitos de contenido
  • Reducir longitud del contenido
  • Reintentar más tarde

CONTENT_003: Créditos insuficientes ​

Descripción: No hay suficientes créditos para generar contenido Causas:

  • Agotamiento de créditos
  • Asignación de créditos expirada
  • Limitaciones del plan Solución:
  • Comprar créditos adicionales
  • Actualizar plan
  • Esperar reinicio mensual

CONTENT_004: Umbral de calidad del contenido no alcanzado ​

Descripción: El contenido generado no pasó las comprobaciones de calidad Causas:

  • Puntuación SEO baja
  • Mala legibilidad
  • Contenido inapropiado Solución:
  • Ajustar requisitos de calidad
  • Ajustar configuración de generación
  • Usar modelo IA diferente

CONTENT_005: Validación de prompt fallida ​

Descripción: El prompt de contenido falló la validación Causas:

  • Contenido inapropiado
  • Violaciones de política
  • Errores de formato Solución:
  • Revisar y modificar el prompt
  • Comprobar políticas de contenido
  • Asegurar formato correcto

Errores de API (API_xxx) ​

API_001: Formato de solicitud inválido ​

Descripción: El formato de la solicitud API es inválido Causas:

  • JSON mal formado
  • Campos requeridos faltantes
  • Tipos de datos inválidos Solución:
  • Validar formato de la solicitud
  • Usar tipos de datos correctos

API_002: Recurso no encontrado ​

Descripción: El recurso solicitado no existe Causas:

  • ID de recurso incorrecto
  • Recurso eliminado
  • Problemas de permisos Solución:
  • Verificar ID del recurso
  • Comprobar que el recurso existe
  • Confirmar permisos de acceso

API_003: Método no permitido ​

Descripción: Método HTTP no soportado para este endpoint Causas:

  • Método HTTP incorrecto
  • Limitaciones del endpoint
  • Problemas de versión API Solución:
  • Usar método HTTP correcto
  • Verificar versión de la API

API_004: Límite de tasa excedido ​

Descripción: Demasiadas solicitudes API en el período Causas:

  • Alta frecuencia de solicitudes
  • Limitaciones del plan
  • Actividad de bot Solución:
  • Implementar rate limiting
  • Actualizar plan para límites más altos
  • Usar backoff exponencial

API_005: Error interno del servidor ​

Descripción: El servidor encontró un error inesperado Causas:

  • Fallo del sistema
  • Problemas de base de datos
  • Problemas de servicios de terceros Solución:
  • Reintentar solicitud después de un retraso
  • Comprobar estado del servicio
  • Contactar soporte si persiste

Errores de integración de plataforma (PLATFORM_xxx) ​

PLATFORM_001: Conexión WordPress fallida ​

Descripción: No se puede conectar al sitio WordPress Causas:

  • Credenciales inválidas
  • Conflictos de plugins
  • Problemas del servidor Solución:
  • Verificar credenciales de WordPress
  • Comprobar compatibilidad de plugins
  • Probar conectividad del sitio

PLATFORM_002: Error de API Wix ​

Descripción: La API de Wix devolvió un error Causas:

  • Clave API inválida
  • Problemas de permisos
  • Interrupción del servicio Solución:
  • Actualizar clave API de Wix
  • Comprobar permisos de la app
  • Monitorear estado del servicio Wix

PLATFORM_003: Timeout de API Webflow ​

Descripción: La solicitud a la API de Webflow expiró Causas:

  • Respuesta lenta
  • Transferencia de datos grande
  • Problemas de red Solución:
  • Reducir tamaño de la solicitud
  • Implementar lógica de reintento
  • Comprobar conectividad de red

PLATFORM_004: Autenticación de plataforma expirada ​

Descripción: La autenticación de la plataforma ha expirado Causas:

  • Sesión de conexión expirada
  • Rotación de clave API
  • Política de seguridad Solución:
  • Re-autenticarse con la plataforma
  • Reconectar tu integración
  • Actualizar configuración de conexión

PLATFORM_005: Función de plataforma no soportada ​

Descripción: La función solicitada no está disponible en la plataforma Causas:

  • Limitaciones de la plataforma
  • Incompatibilidad de versión
  • Deprecación de función Solución:
  • Consultar documentación de la plataforma
  • Actualizar versión de la plataforma
  • Usar funciones alternativas

Errores de campaña (CAMPAIGN_xxx) ​

CAMPAIGN_001: Campaña no encontrada ​

Descripción: La campaña especificada no existe Causas:

  • ID de campaña incorrecto
  • Campaña eliminada
  • Problemas de permisos Solución:
  • Verificar ID de la campaña
  • Comprobar lista de campañas
  • Confirmar permisos de acceso

CAMPAIGN_002: Configuración de campaña inválida ​

Descripción: La configuración de la campaña es inválida Causas:

  • Campos requeridos faltantes
  • Configuración inválida
  • Conflictos de configuración Solución:
  • Revisar configuración de la campaña
  • Comprobar campos requeridos
  • Resolver conflictos de configuración

CAMPAIGN_003: Campaña ya en ejecución ​

Descripción: No se puede modificar campaña en ejecución Causas:

  • Campaña en progreso
  • Publicaciones programadas pendientes
  • Conflictos de recursos Solución:
  • Pausar campaña primero
  • Esperar a que termine
  • Usar procedimientos de modificación apropiados

CAMPAIGN_004: Recursos de campaña insuficientes ​

Descripción: No hay suficientes recursos para la campaña Causas:

  • Escasez de créditos
  • Límites de miembros del equipo
  • Capacidad de la plataforma Solución:
  • Asignar más créditos
  • Añadir miembros del equipo
  • Actualizar plan

CAMPAIGN_005: Conflicto de programación de campaña ​

Descripción: Se detectaron conflictos de programación de campaña Causas:

  • Horas de publicación superpuestas
  • Conflictos de recursos
  • Limitaciones de la plataforma Solución:
  • Ajustar programación de publicación
  • Resolver conflictos de recursos
  • Escalonar programación de campañas

Errores de archivos y medios (FILE_xxx) ​

FILE_001: Subida de archivo fallida ​

Descripción: El archivo no pudo subirse Causas:

  • Tamaño de archivo excedido
  • Formato de archivo inválido
  • Problemas de red Solución:
  • Comprobar límites de tamaño
  • Verificar formatos soportados
  • Reintentar subida

FILE_002: Archivo no encontrado ​

Descripción: El archivo solicitado no existe Causas:

  • Ruta de archivo incorrecta
  • Archivo eliminado
  • Problemas de permisos Solución:
  • Verificar ubicación del archivo
  • Comprobar que el archivo existe
  • Confirmar permisos de acceso

FILE_003: Formato de archivo no soportado ​

Descripción: El formato de archivo no está soportado Causas:

  • Tipo de medio no soportado
  • Archivo corrupto
  • Incompatibilidad de versión Solución:
  • Usar formatos soportados
  • Verificar integridad del archivo
  • Convertir formato del archivo

FILE_004: Tamaño de archivo excedido ​

Descripción: El archivo excede los límites de tamaño Causas:

  • Dimensiones de archivo grandes
  • Alta resolución
  • Limitaciones del plan Solución:
  • Comprimir archivo
  • Reducir dimensiones
  • Actualizar plan

FILE_005: Procesamiento de archivo fallido ​

Descripción: El procesamiento del archivo encontró errores Causas:

  • Archivo corrupto
  • Timeout de procesamiento
  • Limitaciones de recursos Solución:
  • Verificar integridad del archivo
  • Reintentar procesamiento
  • Comprobar recursos del sistema

Errores de facturación y pago (BILLING_xxx) ​

BILLING_001: Pago fallido ​

Descripción: El procesamiento del pago falló Causas:

  • Método de pago inválido
  • Fondos insuficientes
  • Banco rechazó Solución:
  • Actualizar método de pago
  • Verificar saldo de cuenta
  • Contactar banco

BILLING_002: Suscripción expirada ​

Descripción: La suscripción ha expirado Causas:

  • Fallo de pago
  • Cancelación del plan
  • Problemas de facturación Solución:
  • Actualizar método de pago
  • Renovar suscripción
  • Contactar soporte de facturación

BILLING_003: Límite del plan excedido ​

Descripción: Los límites del plan han sido excedidos Causas:

  • Uso excesivo de recursos
  • Limitaciones de funciones
  • Número de usuarios excedido Solución:
  • Actualizar plan
  • Reducir uso
  • Eliminar recursos no usados

BILLING_004: Factura no encontrada ​

Descripción: La factura solicitada no existe Causas:

  • ID de factura incorrecto
  • Factura no generada
  • Permisos de acceso Solución:
  • Verificar ID de factura
  • Comprobar historial de facturación
  • Confirmar derechos de acceso

BILLING_005: Procesamiento de reembolso fallido ​

Descripción: El reembolso no pudo procesarse Causas:

  • Período de reembolso expirado
  • Problemas con método de pago
  • Restricciones de política Solución:
  • Comprobar política de reembolso
  • Actualizar método de pago
  • Contactar soporte de facturación

Mejores prácticas de manejo de errores ​

Manejo del lado del cliente ​

javascript
// Ejemplo de manejo de errores
try {
  const response = await fetch('/api/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(requestData)
  });
  
  if (!response.ok) {
    const error = await response.json();
    handleApiError(error);
    return;
  }
  
  const result = await response.json();
  processResult(result);
} catch (error) {
  handleNetworkError(error);
}

function handleApiError(error) {
  switch (error.code) {
    case 'CONTENT_003':
      showUpgradePrompt();
      break;
    case 'API_004':
      scheduleRetry();
      break;
    case 'AUTH_001':
      redirectToLogin();
      break;
    default:
      showGenericError(error.message);
  }
}

Registro del lado del servidor ​

javascript
// Ejemplo de registro de errores
const logError = (error, context) => {
  const errorLog = {
    timestamp: new Date().toISOString(),
    code: error.code,
    message: error.message,
    context: context,
    stack: error.stack,
    userId: context.userId,
    requestId: context.requestId
  };
  
  // Registrar en sistema de monitoreo
  logger.error('API Error', errorLog);
  
  // Enviar a servicio de seguimiento de errores
  errorTracker.captureException(error, {
    tags: { errorCode: error.code },
    extra: context
  });
};

Obtener ayuda con errores ​

Recursos de autoservicio ​

  • Búsqueda de código de error: Buscar en esta documentación
  • Foros de la comunidad: Discusiones de usuarios
  • Base de conocimientos: Guías de solución de problemas
  • Página de estado: Disponibilidad del servicio

Información para soporte ​

Al contactar soporte sobre errores, proporcionar:

  • Código de error: Identificador específico del error
  • Mensaje de error: Texto completo del error
  • Pasos realizados: Lo que estabas haciendo
  • Info del sistema: Navegador, SO, detalles del dispositivo
  • Marca de tiempo: Cuándo ocurrió el error

Estrategias de prevención ​

  • Validación de entrada: Prevenir solicitudes inválidas
  • Rate limiting: Evitar límites de API
  • Monitoreo de errores: Rastrear patrones de errores
  • Actualizaciones regulares: Mantener sistemas actualizados

Consejo

Incluye siempre el código de error completo y el mensaje al solicitar soporte. Esto nos ayuda a diagnosticar y resolver problemas mucho más rápido.

Copyright © 2026 auto-post.io