Documentación de LumioLearn

LumioLearn es una plataforma para crear, vender y gestionar tu propia academia online. Cada academia es un espacio independiente — con su propia marca, dominio, cursos y alumnos — que tú controlas al 100%.

La plataforma es multi-tenant: tu academia (un tenant) vive en su propio subdominio (tu-academia.lumiolearn.com) o en tu dominio personalizado, con tu logo y tus colores. Tus alumnos nunca ven la marca LumioLearn.

• Crea cursos con video, texto, PDFs y evaluaciones.
• Cobra con tu propia pasarela y 0% de comisión.
• Automatiza el soporte con un Tutor IA entrenado con tu contenido.
• Personaliza todo: marca, dominio y experiencia.

Lanzar tu academia toma menos de 5 minutos:

1. 1Regístrate. Crea tu cuenta desde Crear academia. No necesitas tarjeta.
2. 2Elige tu subdominio. Define el nombre con el que tus alumnos accederán.
3. 3Personaliza tu marca. Sube tu logo, define colores y, si quieres, conecta tu dominio.
4. 4Crea tu primer curso. Añade módulos, lecciones y recursos.
5. 5Conecta tus pagos. Vincula PayPal o MercadoPago y empieza a vender.

El contenido sigue una jerarquía simple que escala desde un curso suelto hasta una institución completa:

Academia (tenant)
└─ Cursos
   └─ Módulos
      └─ Lecciones  (video · texto · PDF · quiz)
Alumnos  →  Membresías  →  Inscripciones a cursos
Equipo   →  Roles (admin · staff · profesor)

Tu academia es un tenant aislado. Por defecto vive en tu-academia.lumiolearn.com, pero puedes conectar un dominio propio como cursos.tumarca.com. Toda la personalización (logo, colores, tipografía, metadatos) se aplica a nivel de academia.

Un curso agrupa módulos, y cada módulo contiene lecciones. Las lecciones soportan video, texto enriquecido, PDFs, recursos descargables y quizzes. Puedes liberar contenido por fechas (drip) y marcar lecciones como vista previa gratuita.

Cuando alguien compra o se inscribe, se crea una membresía que vincula al alumno con tu academia y le da acceso a los cursos correspondientes. Las membresías pueden ser de pago único o por suscripción, y tienen estados (active, past_due, canceled).

LumioLearn no se interpone en tu dinero: conectas tu propia pasarela (PayPal o MercadoPago) y recibes los pagos directamente, al instante y con 0% de comisión por nuestra parte. Soportamos pago único, suscripciones y cupones de descuento.

El Tutor IA se entrena con la transcripción de tus videos y los textos de tus cursos. Cuando un alumno pregunta, responde con el contexto exacto de tu contenido — disponible 24/7 y reduciendo drásticamente tu carga de soporte.

A partir del material de cada módulo, la IA genera evaluaciones con preguntas de opción múltiple, verdadero/falso y respuesta corta. Tú revisas, ajustas y publicas. Las correcciones y los certificados se emiten automáticamente.

La API de LumioLearn es REST, usa JSON en las peticiones y respuestas, y verbos HTTP estándar. Cada academia tiene su propia URL base, sobre su subdominio (o su dominio propio):

https://TU-ACADEMIA.lumiolearn.com/api/v1

Las respuestas son JSON y los errores usan el formato { "error": { "code", "message" } }. El límite es de 100 peticiones por minuto por API key (responde 429 con Retry-After al excederlo).

Las peticiones se autentican con una API key secreta que generas en el panel de tu academia (Ajustes → API Keys). Cada key tiene scopes (read y/o write) y puede expirar. Se muestra una sola vez al crearla: guárdala bien y nunca la expongas en el navegador.

Envíala en la cabecera x-api-key (recomendado) o como Authorization: Bearer. Las keys tienen el formato lum_live_…

curl https://TU-ACADEMIA.lumiolearn.com/api/v1/courses \
  -H "x-api-key: lum_live_tu_api_key"

Recursos principales (autenticados con tu API key):

Listar cursos

curl https://TU-ACADEMIA.lumiolearn.com/api/v1/courses?limit=10 \
  -H "x-api-key: lum_live_tu_api_key"

{
  "data": [
    {
      "id": "9f2c8b1a-…",
      "slug": "fotografia-para-principiantes",
      "title": "Fotografía para principiantes",
      "category": { "name": "Fotografía" }
    }
  ],
  "meta": { "total": 1, "limit": 10 }
}

Crear un curso

Requiere una key con scope write.

curl https://TU-ACADEMIA.lumiolearn.com/api/v1/courses \
  -H "x-api-key: lum_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Marketing con IA",
    "slug": "marketing-con-ia"
  }'

Inscribir a un usuario

Requiere una key con scope write.

curl https://TU-ACADEMIA.lumiolearn.com/api/v1/enrollments \
  -H "x-api-key: lum_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usr_9f2c…",
    "courseId": "9f2c8b1a-…"
  }'

Métricas de la academia

curl https://TU-ACADEMIA.lumiolearn.com/api/v1/stats \
  -H "x-api-key: lum_live_tu_api_key"

{
  "data": {
    "courses": { "total": 12, "published": 9 },
    "enrollments": { "total": 480, "active": 360, "completed": 95 },
    "students": 312,
    "certificates": 88
  }
}

En el roadmap. Estamos trabajando en webhooks firmados para que reacciones en tiempo real a eventos como enrollment.created, payment.succeeded y course.completed. Mientras tanto, puedes consultar los recursos por la API REST. ¿Lo necesitas ya? Cuéntanos en contacto.

La API usa códigos de estado HTTP convencionales. Los errores devuelven un cuerpo JSON con error.code y error.message.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API Key inválida o ausente."
  }
}

Límites: 100 peticiones por minuto por API key. Las respuestas en lista soportan paginación con limit y starting_after.