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. La URL base es:

https://api.lumiolearn.com/v1

Beta. La API pública está en evolución. Los endpoints siguientes son la referencia de integración; escríbenos en contacto para acceso anticipado y tus credenciales.

Las peticiones se autentican con una API key secreta que generas en el panel de tu academia (Ajustes → Desarrolladores). Envíala en la cabecera Authorization como un Bearer token. Nunca la expongas en el navegador.

curl https://api.lumiolearn.com/v1/courses \
  -H "Authorization: Bearer sk_live_tu_api_key"

Algunos de los recursos principales:

Listar cursos

curl https://api.lumiolearn.com/v1/courses?limit=10 \
  -H "Authorization: Bearer sk_live_tu_api_key"

{
  "object": "list",
  "data": [
    {
      "id": "course_a1b2c3",
      "title": "Fotografía para principiantes",
      "status": "published",
      "price": { "amount": 1900, "currency": "USD" },
      "modules_count": 6,
      "students_count": 1240,
      "created_at": "2026-03-12T14:05:00Z"
    }
  ],
  "has_more": false
}

Crear un curso

curl https://api.lumiolearn.com/v1/courses \
  -H "Authorization: Bearer sk_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Marketing con IA",
    "price": { "amount": 4900, "currency": "USD" },
    "status": "draft"
  }'

Inscribir a un alumno

curl https://api.lumiolearn.com/v1/enrollments \
  -H "Authorization: Bearer sk_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "course_id": "course_a1b2c3",
    "student_email": "alumno@email.com"
  }'

Suscríbete a eventos para reaccionar en tiempo real. LumioLearn envía un POST a tu URL con la firma Lumio-Signature para que verifiques la autenticidad. Eventos disponibles: enrollment.created, payment.succeeded, course.completed.

{
  "id": "evt_9f8e7d",
  "type": "payment.succeeded",
  "created_at": "2026-06-20T09:30:00Z",
  "data": {
    "amount": 4900,
    "currency": "USD",
    "course_id": "course_a1b2c3",
    "student_email": "alumno@email.com"
  }
}

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

{
  "error": {
    "type": "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.