Referencia de endpoints¶
Referencia endpoint a endpoint de la API de Didacta, extraída del código real (~100 controllers, ~540 endpoints), organizada en cinco áreas:
🔐 Núcleo y transversales
Auth, MFA, API keys, mi cuenta, setup, licencia, branding, storage, auditoría, SSO, SCIM, inscripción externa y webhooks.
🛠️ Administración
Organizaciones, usuarios, invitaciones, módulos, SMTP, identidad corporativa (EE), IA, moderación y Fundae.
🎓 Aprendizaje
Cursos, matrículas y progreso, drip, SCORM, rutas, evaluaciones, certificados, grupos de acceso y Fundae.
👥 Comunidad y personas
Comunidad, mensajería SSE, gamificación, recursos, encuestas, referidos, theming, inscripción y membresía.
💳 Pagos, aula virtual e IA
Billing, suscripciones, conexiones de pago, Zoom en directo y los tres módulos de IA.
Cómo leer la referencia¶
- Todas las rutas cuelgan de
/api/v1salvo las marcadas con ⚠ (/healthz,/metrics,/api/license,/scim/v2). - La columna Auth indica el mínimo necesario:
Público(sin sesión, tenant resuelto por dominio),Bearer(cualquier usuario autenticado),formador+/staff,admin(tenant_admin o super_admin),super_admin,ApiKey+ scope, o una firma de webhook. - Los endpoints Enterprise responden 402 con la capability requerida en el cuerpo; los de un módulo desactivado para el tenant, 403.
- Los errores de dominio llevan un campo
codeestable (COURSE_SLUG_EXISTS,SUBSCRIPTIONS_STRIPE_CONFIG_MISSING…) pensado para programar contra él.
El contrato fino, en tu Swagger
Esta referencia cubre rutas, auth, propósito, cuerpos principales y errores. Los schemas exactos de request/response de tu versión desplegada están siempre en el Swagger de tu instancia: https://tu-instancia/api/docs (JSON en /api/docs.json).